-
+
+
+
+
- Crafted for engineering teams shipping with AI
+ Less setup. Sharper AI outputs.
+
- DevContext — AI Coding Guidelines & Context Generator
+ Build concise AI coding guardrails your team will actually use
+
- Generate AI config files like Copilot instructions, Cursor rules, and prompts — consistent, fast, and IDE-ready. Bring product context, architecture, and workflow nuance into every coding session.
+ Jump in with a ready-made stack template, explore the full wizard, or drop a GitHub repo for an automatic scan.
+
+
+ {featureHighlights.map((feature) => (
+
+
+ {feature}
+
+ ))}
+
+
-
-
+
+
+
+ Start fast with popular stacks
+
+
+
+
+ {popularStacks.map((stack) => {
+ const descriptor = getIconDescriptor(stack.icon ?? stack.value)
+ const iconHex = descriptor ? iconColorOverrides[descriptor.slug] ?? descriptor.hex : undefined
+ const iconColor = iconHex ? getAccessibleIconColor(iconHex) : undefined
+ const iconBackground = iconColor ? hexToRgba(iconColor, 0.18) ?? undefined : undefined
+ const iconRing = iconColor ? hexToRgba(iconColor, 0.32) ?? undefined : undefined
+ const initials = getFallbackInitials(stack.label)
+
+ return (
+
+ )
+ })}
+
+
diff --git a/components/Logo/logo-dark.svg b/components/Logo/logo-dark.svg
deleted file mode 100644
index 18d46ca..0000000
--- a/components/Logo/logo-dark.svg
+++ /dev/null
@@ -1,136 +0,0 @@
-
\ No newline at end of file
diff --git a/components/Logo/logo.svg b/components/Logo/logo.svg
deleted file mode 100644
index 3b3c348..0000000
--- a/components/Logo/logo.svg
+++ /dev/null
@@ -1,137 +0,0 @@
-
-
diff --git a/components/Logo/logoText.svg b/components/Logo/logoText.svg
deleted file mode 100644
index 33e8d56..0000000
--- a/components/Logo/logoText.svg
+++ /dev/null
@@ -1,1579 +0,0 @@
-
-
diff --git a/components/instructions-wizard.tsx b/components/instructions-wizard.tsx
index e017d1e..19caecf 100644
--- a/components/instructions-wizard.tsx
+++ b/components/instructions-wizard.tsx
@@ -1,157 +1,45 @@
"use client"
import { useCallback, useEffect, useMemo, useRef, useState } from "react"
+import Link from "next/link"
+
import { Button } from "@/components/ui/button"
import { Undo2 } from "lucide-react"
-import type { DataQuestionSource, InstructionsWizardProps, Responses, WizardAnswer, WizardConfirmationIntent, WizardQuestion, WizardStep } from "@/types/wizard"
+import type { InstructionsWizardProps, Responses, WizardAnswer, WizardQuestion, WizardStep, WizardConfirmationIntent } from "@/types/wizard"
import { buildFilterPlaceholder, useAnswerFilter } from "@/hooks/use-answer-filter"
-import stacksData from "@/data/stacks.json"
-import generalData from "@/data/general.json"
-import architectureData from "@/data/architecture.json"
-import performanceData from "@/data/performance.json"
-import securityData from "@/data/security.json"
-import commitsData from "@/data/commits.json"
-import filesData from "@/data/files.json"
-import FinalOutputView from "./final-output-view"
+import {
+ STACK_QUESTION_ID,
+ STACK_STEP_ID,
+ loadStackWizardStep,
+ stackQuestion,
+ stacksStep,
+ getSuffixSteps,
+} from "@/lib/wizard-config"
+import { persistWizardState, clearWizardState } from "@/lib/wizard-storage"
import { WizardAnswerGrid } from "./wizard-answer-grid"
-import { WizardCompletionSummary } from "./wizard-completion-summary"
import { WizardConfirmationDialog } from "./wizard-confirmation-dialog"
-import { WizardEditAnswerDialog } from "./wizard-edit-answer-dialog"
-import { generateInstructions } from "@/lib/instructions-api"
-import { buildCompletionSummary } from "@/lib/wizard-summary"
-import { serializeWizardResponses } from "@/lib/wizard-response"
-import { buildFileOptionsFromQuestion, buildStepFromQuestionSet, getFormatLabel, mapAnswerSourceToWizard } from "@/lib/wizard-utils"
-import type { GeneratedFileResult } from "@/types/output"
+const suffixSteps = getSuffixSteps()
-const STACK_STEP_ID = "stacks"
-const STACK_QUESTION_ID = "stackSelection"
-const DEVCONTEXT_ROOT_URL = "https://devcontext.xyz/"
-
-const stackQuestionSet = stacksData as DataQuestionSource[]
-const stacksStep = buildStepFromQuestionSet(
- STACK_STEP_ID,
- "Choose Your Stack",
- stackQuestionSet
-)
-const stackQuestion = stacksStep.questions.find((question) => question.id === STACK_QUESTION_ID) ?? null
-
-const fileQuestionSet = filesData as DataQuestionSource[]
-const fileQuestion = fileQuestionSet[0] ?? null
-const fileOptions = buildFileOptionsFromQuestion(fileQuestion)
-const defaultFileOption =
- fileOptions.find((file) => file.isDefault) ??
- fileOptions[0] ??
- null
-const fileSummaryQuestion = fileQuestion
- ? {
- id: fileQuestion.id,
- question: fileQuestion.question,
- isReadOnlyOnSummary: fileQuestion.isReadOnlyOnSummary,
- }
- : null
-
-const generalStep = buildStepFromQuestionSet(
- "general",
- "Project Foundations",
- generalData as DataQuestionSource[]
-)
-
-const architectureStep = buildStepFromQuestionSet(
- "architecture",
- "Architecture Practices",
- architectureData as DataQuestionSource[]
-)
-
-const performanceStep = buildStepFromQuestionSet(
- "performance",
- "Performance Guidelines",
- performanceData as DataQuestionSource[]
-)
-
-const securityStep = buildStepFromQuestionSet(
- "security",
- "Security & Compliance",
- securityData as DataQuestionSource[]
-)
-
-const commitsStep = buildStepFromQuestionSet(
- "commits",
- "Collaboration & Version Control",
- commitsData as DataQuestionSource[]
-)
-
-const suffixSteps: WizardStep[] = [
- generalStep,
- architectureStep,
- performanceStep,
- securityStep,
- commitsStep,
-]
-
-export function InstructionsWizard({ onClose, selectedFileId, initialStackId }: InstructionsWizardProps) {
+export function InstructionsWizard({
+ initialStackId,
+ onStackSelected,
+ onStackCleared,
+ autoStartAfterStackSelection = true,
+ onComplete,
+}: InstructionsWizardProps) {
const [currentStepIndex, setCurrentStepIndex] = useState(0)
const [currentQuestionIndex, setCurrentQuestionIndex] = useState(0)
const [responses, setResponses] = useState
({})
const [dynamicSteps, setDynamicSteps] = useState([])
- const [isComplete, setIsComplete] = useState(false)
- const [pendingConfirmation, setPendingConfirmation] = useState(null)
- const [generatedFile, setGeneratedFile] = useState(null)
- const [isGenerating, setIsGenerating] = useState(false)
const [isStackFastTrackPromptVisible, setIsStackFastTrackPromptVisible] = useState(false)
+ const [pendingConfirmation, setPendingConfirmation] = useState(null)
const [autoFilledQuestionMap, setAutoFilledQuestionMap] = useState>({})
- const [autoFillNotice, setAutoFillNotice] = useState(null)
- const [activeEditQuestionId, setActiveEditQuestionId] = useState(null)
const hasAppliedInitialStack = useRef(null)
+ const [activeStackLabel, setActiveStackLabel] = useState(null)
- useEffect(() => {
- if (!isComplete && activeEditQuestionId) {
- setActiveEditQuestionId(null)
- }
- }, [isComplete, activeEditQuestionId])
-
- const selectedFile = useMemo(() => {
- if (selectedFileId) {
- const matchedFile = fileOptions.find((file) => file.id === selectedFileId)
- if (matchedFile) {
- return matchedFile
- }
- }
-
- return defaultFileOption
- }, [selectedFileId])
-
- const selectedFileFormatLabel = useMemo(
- () => (selectedFile ? getFormatLabel(selectedFile.format) : null),
- [selectedFile]
- )
-
- const wizardSteps = useMemo(
- () => [stacksStep, ...dynamicSteps, ...suffixSteps],
- [dynamicSteps]
- )
-
- const nonStackSteps = useMemo(
- () => wizardSteps.filter((step) => step.id !== STACK_STEP_ID),
- [wizardSteps]
- )
-
- const wizardQuestionsById = useMemo(() => {
- const lookup: Record = {}
-
- wizardSteps.forEach((step) => {
- step.questions.forEach((question) => {
- lookup[question.id] = question
- })
- })
-
- return lookup
- }, [wizardSteps])
-
- const editingQuestion = activeEditQuestionId ? wizardQuestionsById[activeEditQuestionId] ?? null : null
- const editingAnswerValue = editingQuestion ? responses[editingQuestion.id] : undefined
-
+ const wizardSteps = useMemo(() => [stacksStep, ...dynamicSteps, ...suffixSteps], [dynamicSteps])
const currentStep = wizardSteps[currentStepIndex] ?? null
const currentQuestion = currentStep?.questions[currentQuestionIndex] ?? null
@@ -161,6 +49,7 @@ export function InstructionsWizard({ onClose, selectedFileId, initialStackId }:
setQuery: setAnswerFilterQuery,
isFiltering: isFilteringAnswers,
} = useAnswerFilter(currentQuestion ?? null)
+
const filterPlaceholder = buildFilterPlaceholder(currentQuestion ?? null)
const showNoFilterMatches = Boolean(
currentQuestion?.enableFilter &&
@@ -169,29 +58,6 @@ export function InstructionsWizard({ onClose, selectedFileId, initialStackId }:
)
const filterInputId = currentQuestion ? `answer-filter-${currentQuestion.id}` : "answer-filter"
- const totalQuestions = useMemo(
- () => wizardSteps.reduce((count, step) => count + step.questions.length, 0),
- [wizardSteps]
- )
-
- const remainingQuestionCount = useMemo(
- () => nonStackSteps.reduce((count, step) => count + step.questions.length, 0),
- [nonStackSteps]
- )
-
- const completionSummary = useMemo(
- () =>
- buildCompletionSummary(
- fileSummaryQuestion,
- selectedFile ?? null,
- selectedFileFormatLabel,
- wizardSteps,
- responses,
- autoFilledQuestionMap
- ),
- [selectedFile, selectedFileFormatLabel, wizardSteps, responses, autoFilledQuestionMap]
- )
-
const currentAnswerValue = currentQuestion ? responses[currentQuestion.id] : undefined
const defaultAnswer = useMemo(
@@ -212,7 +78,6 @@ export function InstructionsWizard({ onClose, selectedFileId, initialStackId }:
}, [currentAnswerValue, currentQuestion, defaultAnswer])
const canUseDefault = Boolean(
- !isComplete &&
currentQuestion &&
defaultAnswer &&
!defaultAnswer.disabled &&
@@ -223,8 +88,10 @@ export function InstructionsWizard({ onClose, selectedFileId, initialStackId }:
? `Use default (${defaultAnswer.label})`
: "Use default"
- const showStackPivot = !isComplete && isStackFastTrackPromptVisible
- const showQuestionControls = !isComplete && !isStackFastTrackPromptVisible
+ const selectedStackId = useMemo(() => {
+ const value = responses[STACK_QUESTION_ID]
+ return typeof value === "string" && value.length > 0 ? value : null
+ }, [responses])
const markQuestionsAutoFilled = useCallback((questionIds: string[]) => {
if (questionIds.length === 0) {
@@ -254,17 +121,97 @@ export function InstructionsWizard({ onClose, selectedFileId, initialStackId }:
})
}, [])
- const closeEditDialog = useCallback(() => {
- setActiveEditQuestionId(null)
- }, [])
+ const persistStateIfPossible = useCallback(
+ (nextResponses: Responses, nextAutoFilled: Record, stackId: string | null, stackLabel?: string | null) => {
+ if (!stackId) {
+ return
+ }
- const isAnswerSelected = (value: string) => {
- if (currentQuestion?.allowMultiple) {
- return Array.isArray(currentAnswerValue) && currentAnswerValue.includes(value)
+ persistWizardState({
+ stackId,
+ stackLabel: stackLabel ?? undefined,
+ responses: nextResponses,
+ autoFilledMap: nextAutoFilled,
+ updatedAt: Date.now(),
+ })
+ },
+ []
+ )
+
+ const loadStackQuestions = useCallback(
+ async (
+ stackId: string,
+ stackLabelFromAnswer?: string,
+ options?: { skipFastTrackPrompt?: boolean }
+ ) => {
+ try {
+ const { step, label } = await loadStackWizardStep(stackId, stackLabelFromAnswer)
+ setActiveStackLabel(label)
+
+ setDynamicSteps([step])
+ setIsStackFastTrackPromptVisible(!options?.skipFastTrackPrompt && step.questions.length > 0)
+
+ setResponses((prev) => {
+ const next: Responses = { ...prev }
+ step.questions.forEach((question) => {
+ delete next[question.id]
+ })
+ return next
+ })
+ setCurrentStepIndex(1)
+ setCurrentQuestionIndex(0)
+ setAutoFilledQuestionMap({})
+ } catch (error) {
+ console.error(`Unable to load questions for stack "${stackId}"`, error)
+ setDynamicSteps([])
+ setIsStackFastTrackPromptVisible(false)
+ }
+ },
+ []
+ )
+
+ useEffect(() => {
+ if (!initialStackId) {
+ return
}
- return currentAnswerValue === value
- }
+ if (hasAppliedInitialStack.current === initialStackId) {
+ return
+ }
+
+ const stackAnswer = stackQuestion?.answers.find((answer) => answer.value === initialStackId)
+
+ if (!stackAnswer) {
+ return
+ }
+
+ hasAppliedInitialStack.current = initialStackId
+
+ setResponses((prev) => ({
+ ...prev,
+ [STACK_QUESTION_ID]: stackAnswer.value,
+ }))
+
+ void loadStackQuestions(stackAnswer.value, stackAnswer.label, {
+ skipFastTrackPrompt: autoStartAfterStackSelection,
+ })
+ }, [initialStackId, loadStackQuestions, autoStartAfterStackSelection])
+
+ useEffect(() => {
+ if (!selectedStackId) {
+ return
+ }
+
+ persistStateIfPossible(responses, autoFilledQuestionMap, selectedStackId, activeStackLabel)
+ }, [responses, autoFilledQuestionMap, selectedStackId, activeStackLabel, persistStateIfPossible])
+
+ const handleWizardCompletion = useCallback(() => {
+ if (!selectedStackId) {
+ return
+ }
+
+ onComplete?.(selectedStackId)
+ }, [selectedStackId, onComplete])
const advanceToNextQuestion = () => {
const currentStepForAdvance = wizardSteps[currentStepIndex]
@@ -273,7 +220,7 @@ export function InstructionsWizard({ onClose, selectedFileId, initialStackId }:
const isLastStep = currentStepIndex === wizardSteps.length - 1
if (isLastQuestionInStep && isLastStep) {
- setIsComplete(true)
+ handleWizardCompletion()
return
}
@@ -303,99 +250,13 @@ export function InstructionsWizard({ onClose, selectedFileId, initialStackId }:
const previousStep = wizardSteps[previousStepIndex]
setCurrentStepIndex(previousStepIndex)
setCurrentQuestionIndex(previousStep.questions.length - 1)
- setIsComplete(false)
return
}
setCurrentQuestionIndex((prev) => Math.max(prev - 1, 0))
- setIsComplete(false)
}
- const loadStackQuestions = useCallback(async (stackId: string, stackLabel?: string) => {
- try {
- setGeneratedFile(null)
-
- const questionsModule = await import(`@/data/questions/${stackId}.json`)
- const questionsData = (questionsModule.default ?? questionsModule) as DataQuestionSource[]
-
- const mappedQuestions: WizardQuestion[] = questionsData.map((question) => ({
- id: question.id,
- question: question.question,
- allowMultiple: question.allowMultiple,
- responseKey: question.responseKey,
- answers: question.answers.map(mapAnswerSourceToWizard),
- }))
-
- const followUpQuestionCount =
- mappedQuestions.length + suffixSteps.reduce((count, step) => count + step.questions.length, 0)
-
- setAutoFilledQuestionMap({})
- setAutoFillNotice(null)
-
- const resolvedStackLabel =
- stackLabel ?? stackQuestion?.answers.find((answer) => answer.value === stackId)?.label ?? stackId
-
- setDynamicSteps([
- {
- id: `stack-${stackId}`,
- title: `${resolvedStackLabel} Preferences`,
- questions: mappedQuestions,
- },
- ])
-
- setIsStackFastTrackPromptVisible(followUpQuestionCount > 0)
-
- setResponses((prev) => {
- const next = { ...prev }
- mappedQuestions.forEach((question) => {
- delete next[question.id]
- })
- return next
- })
-
- setCurrentStepIndex(1)
- setCurrentQuestionIndex(0)
- setIsComplete(false)
- } catch (error) {
- console.error(`Unable to load questions for stack "${stackId}"`, error)
- setDynamicSteps([])
- setIsStackFastTrackPromptVisible(false)
- }
- }, [])
-
- useEffect(() => {
- if (!initialStackId) {
- return
- }
-
- if (hasAppliedInitialStack.current === initialStackId) {
- return
- }
-
- const stackAnswer = stackQuestion?.answers.find((answer) => answer.value === initialStackId)
-
- if (!stackAnswer) {
- return
- }
-
- hasAppliedInitialStack.current = initialStackId
-
- setResponses((prev) => ({
- ...prev,
- [STACK_QUESTION_ID]: stackAnswer.value,
- }))
-
- void loadStackQuestions(stackAnswer.value, stackAnswer.label)
- }, [initialStackId, loadStackQuestions])
-
- if (!currentStep || !currentQuestion) {
- return null
- }
-
- const applyDefaultsAcrossWizard = () => {
- setGeneratedFile(null)
- setAutoFilledQuestionMap({})
-
+ const applyDefaultsAcrossWizard = useCallback(() => {
const autoFilledIds: string[] = []
setResponses((prev) => {
@@ -425,23 +286,9 @@ export function InstructionsWizard({ onClose, selectedFileId, initialStackId }:
})
markQuestionsAutoFilled(autoFilledIds)
-
- if (autoFilledIds.length > 0) {
- setAutoFillNotice("We applied the recommended defaults for you. Tweak any section before generating.")
- } else {
- setAutoFillNotice(null)
- }
-
setIsStackFastTrackPromptVisible(false)
-
- const lastStepIndex = Math.max(wizardSteps.length - 1, 0)
- const lastStep = wizardSteps[lastStepIndex]
- const lastQuestionIndex = lastStep ? Math.max(lastStep.questions.length - 1, 0) : 0
-
- setCurrentStepIndex(lastStepIndex)
- setCurrentQuestionIndex(lastQuestionIndex)
- setIsComplete(true)
- }
+ handleWizardCompletion()
+ }, [markQuestionsAutoFilled, wizardSteps, handleWizardCompletion])
const beginStepByStepFlow = () => {
const firstNonStackIndex = wizardSteps.findIndex((step) => step.id !== STACK_STEP_ID)
@@ -452,22 +299,6 @@ export function InstructionsWizard({ onClose, selectedFileId, initialStackId }:
}
setIsStackFastTrackPromptVisible(false)
- setIsComplete(false)
- setAutoFillNotice(null)
- }
-
- const handleEditEntry = (entryId: string) => {
- if (!entryId) {
- return
- }
-
- const question = wizardQuestionsById[entryId]
-
- if (!question) {
- return
- }
-
- setActiveEditQuestionId(entryId)
}
const handleQuestionAnswerSelection = async (
@@ -479,8 +310,6 @@ export function InstructionsWizard({ onClose, selectedFileId, initialStackId }:
return
}
- setGeneratedFile(null)
-
const prevValue = responses[question.id]
let nextValue: Responses[keyof Responses]
let didAddSelection = false
@@ -526,10 +355,14 @@ export function InstructionsWizard({ onClose, selectedFileId, initialStackId }:
if (isStackQuestion) {
if (nextValue === answer.value) {
- await loadStackQuestions(answer.value, answer.label)
+ await loadStackQuestions(answer.value, answer.label, {
+ skipFastTrackPrompt: autoStartAfterStackSelection,
+ })
+ onStackSelected?.(answer.value, answer.label)
} else {
setDynamicSteps([])
setIsStackFastTrackPromptVisible(false)
+ onStackCleared?.()
}
}
}
@@ -543,12 +376,10 @@ export function InstructionsWizard({ onClose, selectedFileId, initialStackId }:
}
const applyDefaultAnswer = async () => {
- if (!defaultAnswer || defaultAnswer.disabled) {
+ if (!defaultAnswer || defaultAnswer.disabled || !currentQuestion) {
return
}
- setGeneratedFile(null)
-
const nextValue: Responses[keyof Responses] = currentQuestion.allowMultiple
? [defaultAnswer.value]
: defaultAnswer.value
@@ -563,7 +394,10 @@ export function InstructionsWizard({ onClose, selectedFileId, initialStackId }:
const isStackQuestion = currentQuestion.id === STACK_QUESTION_ID
if (isStackQuestion) {
- await loadStackQuestions(defaultAnswer.value, defaultAnswer.label)
+ await loadStackQuestions(defaultAnswer.value, defaultAnswer.label, {
+ skipFastTrackPrompt: autoStartAfterStackSelection,
+ })
+ onStackSelected?.(defaultAnswer.value, defaultAnswer.label)
return
}
@@ -571,40 +405,31 @@ export function InstructionsWizard({ onClose, selectedFileId, initialStackId }:
advanceToNextQuestion()
}, 0)
}
+
const resetWizardState = () => {
+ const stackIdToClear = selectedStackId
setResponses({})
setDynamicSteps([])
setCurrentStepIndex(0)
setCurrentQuestionIndex(0)
- setIsComplete(false)
- setGeneratedFile(null)
- setIsGenerating(false)
setIsStackFastTrackPromptVisible(false)
setAutoFilledQuestionMap({})
- setAutoFillNotice(null)
+ setActiveStackLabel(null)
hasAppliedInitialStack.current = null
+ if (stackIdToClear) {
+ clearWizardState(stackIdToClear)
+ }
}
const resetWizard = () => {
- if (onClose) {
- resetWizardState()
- onClose()
- return
- }
-
resetWizardState()
+ onStackCleared?.()
}
const requestResetWizard = () => {
setPendingConfirmation("reset")
}
- const requestChangeFile = () => {
- if (typeof window !== "undefined") {
- window.location.assign(DEVCONTEXT_ROOT_URL)
- }
- }
-
const confirmPendingConfirmation = () => {
if (!pendingConfirmation) {
return
@@ -614,15 +439,6 @@ export function InstructionsWizard({ onClose, selectedFileId, initialStackId }:
resetWizard()
}
- if (pendingConfirmation === "change-file") {
- if (typeof window !== "undefined") {
- window.location.assign(DEVCONTEXT_ROOT_URL)
- return
- }
- resetWizard()
- onClose?.()
- }
-
setPendingConfirmation(null)
}
@@ -630,99 +446,53 @@ export function InstructionsWizard({ onClose, selectedFileId, initialStackId }:
setPendingConfirmation(null)
}
- const generateInstructionsFile = async () => {
- if (isGenerating) {
- return
- }
-
- const outputFileId = selectedFile?.id ?? null
- if (!outputFileId) {
- console.error("No instructions file selected. Cannot generate output.")
- return
+ const isAnswerSelected = (value: string) => {
+ if (currentQuestion?.allowMultiple) {
+ return Array.isArray(currentAnswerValue) && currentAnswerValue.includes(value)
}
- setIsGenerating(true)
- setGeneratedFile(null)
-
- try {
- const questionsAndAnswers = serializeWizardResponses(wizardSteps, responses, outputFileId)
-
- console.log("Template combination data:", {
- outputFile: questionsAndAnswers.outputFile,
- stack: questionsAndAnswers.stackSelection,
- })
-
- const stackSegment = questionsAndAnswers.stackSelection ?? "general"
- const fileConfig = fileOptions.find((file) => file.id === outputFileId)
-
- const result = await generateInstructions({
- stackSegment,
- outputFileId,
- responses: questionsAndAnswers,
- fileFormat: fileConfig?.format,
- })
-
- if (result) {
- setGeneratedFile(result)
- }
- } catch (error) {
- console.error("Error calling generate API:", error)
- } finally {
- setIsGenerating(false)
- }
+ return currentAnswerValue === value
}
const questionNumber = wizardSteps
.slice(0, currentStepIndex)
.reduce((count, step) => count + step.questions.length, 0) + currentQuestionIndex + 1
+ const totalQuestions = useMemo(
+ () => wizardSteps.reduce((count, step) => count + step.questions.length, 0),
+ [wizardSteps]
+ )
+
+ const remainingQuestionCount = useMemo(() => {
+ return wizardSteps
+ .slice(currentStepIndex)
+ .reduce((count, step, stepIndex) => {
+ if (stepIndex === 0) {
+ return count + (step.questions.length - currentQuestionIndex)
+ }
+ return count + step.questions.length
+ }, 0)
+ }, [wizardSteps, currentStepIndex, currentQuestionIndex])
+
const isAtFirstQuestion = currentStepIndex === 0 && currentQuestionIndex === 0
- const backDisabled = isAtFirstQuestion && !isComplete
- const defaultButtonTitle = !canUseDefault
- ? isComplete
- ? "Questions complete"
- : defaultAnswer?.disabled
- ? "Default option unavailable"
- : isDefaultSelected && !currentQuestion.allowMultiple
- ? "Default already selected"
- : defaultAnswer
- ? undefined
- : "No default available"
- : undefined
- const showChangeFile = Boolean(onClose && selectedFile)
-
- const topButtonLabel = showStackPivot ? "Choose a different stack" : "Start Over"
- const topButtonHandler = showStackPivot ? () => goToPrevious() : () => requestResetWizard()
+ const backDisabled = isAtFirstQuestion
+
+ if (!currentStep || !currentQuestion) {
+ return null
+ }
const wizardLayout = (
-
-
- {selectedFile ? (
-
-
-
-
- {selectedFile.filename ?? selectedFile.label}
-
-
- {showChangeFile ? (
-
- ) : null}
-
- ) : null}
-
- {showStackPivot ? (
+
+
+ DevContext
+
+
+
+ {isStackFastTrackPromptVisible ? (
@@ -730,30 +500,21 @@ export function InstructionsWizard({ onClose, selectedFileId, initialStackId }:
Skip the deep dive?
We can auto-apply the recommended answers for the next {remainingQuestionCount}{" "}
- {remainingQuestionCount === 1 ? "question" : "questions"} across these sections. (You can still tweak the defaults.)
+ {remainingQuestionCount === 1 ? "question" : "questions"}. You can still tweak everything later.
-
-
-
-
-
+
+
+
-
- ) : null}
-
- {showQuestionControls ? (
+ ) : (
@@ -770,7 +531,6 @@ export function InstructionsWizard({ onClose, selectedFileId, initialStackId }:
variant="outline"
onClick={() => void applyDefaultAnswer()}
disabled={!canUseDefault}
- title={defaultButtonTitle}
>
{defaultButtonLabel}
@@ -797,19 +557,19 @@ export function InstructionsWizard({ onClose, selectedFileId, initialStackId }:
placeholder={filterPlaceholder}
className="w-full rounded-lg border border-border/70 bg-background/80 px-3 py-2 text-sm text-foreground shadow-sm transition focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-primary/60"
/>
+ {isFilteringAnswers ? (
+
+ Filtering…
+
+ ) : null}
- {isFilteringAnswers && !showNoFilterMatches ? (
-
- Showing {filteredAnswers.length} of {currentQuestion.answers.length}
-
- ) : null}
) : null}
- No options match “{answerFilterQuery}”. Try a different search.
+ No options match “{answerFilterQuery}”. Try a different search.
) : (
)}
-
+
Question {questionNumber} of {totalQuestions}
+
- ) : null}
-
- {isComplete ? (
-
void generateInstructionsFile()}
- isGenerating={isGenerating}
- autoFillNotice={autoFillNotice}
- onEditEntry={handleEditEntry}
- />
- ) : null}
-
- {pendingConfirmation ? (
-
- ) : null}
+ )}
@@ -32,7 +41,11 @@ export function WizardCompletionSummary({
-
@@ -44,6 +57,43 @@ export function WizardCompletionSummary({
) : null}
+
+
+
+
+ Output file
+
+
+ Pick the instructions file format to generate. You can change this anytime.
+
+
+ {selectedOption ? (
+
+ {selectedOption.filename}
+
+ ) : null}
+
+
+ {fileOptions.map((file) => {
+ const isSelected = file.id === selectedFileId
+ return (
+
+ )
+ })}
+
+
{summary.map((entry) => (
{entry.question}
- {entry.isAutoFilled ? (
-
- Default applied
-
- ) : null}
{entry.hasSelection ? (
diff --git a/components/wizard-confirmation-dialog.tsx b/components/wizard-confirmation-dialog.tsx
index f9664b0..f3edb95 100644
--- a/components/wizard-confirmation-dialog.tsx
+++ b/components/wizard-confirmation-dialog.tsx
@@ -17,11 +17,6 @@ const copyByIntent: Record question.id === STACK_QUESTION_ID) ?? null
+
+const fileQuestionSet = filesData as DataQuestionSource[]
+const fileQuestion = fileQuestionSet[0] ?? null
+const fileOptionsInternal = buildFileOptionsFromQuestion(fileQuestion)
+const fileSummaryQuestionInternal = fileQuestion
+ ? {
+ id: fileQuestion.id,
+ question: fileQuestion.question,
+ isReadOnlyOnSummary: fileQuestion.isReadOnlyOnSummary,
+ }
+ : null
+
+const generalStep = buildStepFromQuestionSet(
+ "general",
+ "Project Foundations",
+ generalData as DataQuestionSource[]
+)
+
+const architectureStep = buildStepFromQuestionSet(
+ "architecture",
+ "Architecture Practices",
+ architectureData as DataQuestionSource[]
+)
+
+const performanceStep = buildStepFromQuestionSet(
+ "performance",
+ "Performance Guidelines",
+ performanceData as DataQuestionSource[]
+)
+
+const securityStep = buildStepFromQuestionSet(
+ "security",
+ "Security & Compliance",
+ securityData as DataQuestionSource[]
+)
+
+const commitsStep = buildStepFromQuestionSet(
+ "commits",
+ "Collaboration & Version Control",
+ commitsData as DataQuestionSource[]
+)
+
+const suffixStepsInternal: WizardStep[] = [
+ generalStep,
+ architectureStep,
+ performanceStep,
+ securityStep,
+ commitsStep,
+]
+
+export const getSuffixSteps = () => suffixStepsInternal
+export const getFileOptions = (): FileOutputConfig[] => fileOptionsInternal
+export const getFileSummaryQuestion = () => fileSummaryQuestionInternal
+export const getDefaultFileOption = () => fileOptionsInternal.find((file) => file.isDefault) ?? fileOptionsInternal[0] ?? null
+
+export const loadStackWizardStep = async (stackId: string, stackLabel?: string): Promise<{ step: WizardStep; label: string }> => {
+ const stackAnswerLabel =
+ stackLabel ?? stackQuestion?.answers.find((answer) => answer.value === stackId)?.label ?? stackId
+
+ const questionsModule = await import(`@/data/questions/${stackId}.json`)
+ const questionsData = (questionsModule.default ?? questionsModule) as DataQuestionSource[]
+
+ const mappedQuestions: WizardQuestion[] = questionsData.map((question) => ({
+ id: question.id,
+ question: question.question,
+ allowMultiple: question.allowMultiple,
+ responseKey: question.responseKey,
+ answers: question.answers.map(mapAnswerSourceToWizard),
+ }))
+
+ return {
+ step: {
+ id: `stack-${stackId}`,
+ title: `${stackAnswerLabel} Preferences`,
+ questions: mappedQuestions,
+ },
+ label: stackAnswerLabel,
+ }
+}
diff --git a/lib/wizard-storage.ts b/lib/wizard-storage.ts
new file mode 100644
index 0000000..0f097b0
--- /dev/null
+++ b/lib/wizard-storage.ts
@@ -0,0 +1,59 @@
+import type { Responses } from "@/types/wizard"
+
+export type StoredWizardState = {
+ stackId: string
+ stackLabel?: string
+ responses: Responses
+ autoFilledMap: Record
+ updatedAt: number
+}
+
+const STORAGE_PREFIX = "devcontext:wizard"
+
+const buildStorageKey = (stackId: string) => `${STORAGE_PREFIX}:${stackId}`
+
+export const persistWizardState = (state: StoredWizardState) => {
+ if (typeof window === "undefined") {
+ return
+ }
+
+ try {
+ const key = buildStorageKey(state.stackId)
+ window.localStorage.setItem(key, JSON.stringify(state))
+ } catch (error) {
+ console.warn("Unable to persist wizard state", error)
+ }
+}
+
+export const loadWizardState = (stackId: string): StoredWizardState | null => {
+ if (typeof window === "undefined") {
+ return null
+ }
+
+ try {
+ const key = buildStorageKey(stackId)
+ const raw = window.localStorage.getItem(key)
+ if (!raw) {
+ return null
+ }
+
+ const parsed = JSON.parse(raw) as StoredWizardState
+ return parsed
+ } catch (error) {
+ console.warn("Unable to load wizard state", error)
+ return null
+ }
+}
+
+export const clearWizardState = (stackId: string) => {
+ if (typeof window === "undefined") {
+ return
+ }
+
+ try {
+ const key = buildStorageKey(stackId)
+ window.localStorage.removeItem(key)
+ } catch (error) {
+ console.warn("Unable to clear wizard state", error)
+ }
+}
diff --git a/lib/wizard-summary-data.ts b/lib/wizard-summary-data.ts
new file mode 100644
index 0000000..1eb0525
--- /dev/null
+++ b/lib/wizard-summary-data.ts
@@ -0,0 +1,68 @@
+import type { Responses, WizardStep } from "@/types/wizard"
+import {
+ STACK_QUESTION_ID,
+ getSuffixSteps,
+ loadStackWizardStep,
+ stacksStep,
+} from "@/lib/wizard-config"
+
+export type DefaultSummaryData = {
+ steps: WizardStep[]
+ responses: Responses
+ autoFilledMap: Record
+ stackLabel: string
+}
+
+const buildDefaultsForSteps = (steps: WizardStep[], stackId: string): {
+ responses: Responses
+ autoFilledMap: Record
+} => {
+ const responses: Responses = {
+ [STACK_QUESTION_ID]: stackId,
+ }
+ const autoFilledMap: Record = {}
+
+ steps.forEach((step) => {
+ step.questions.forEach((question) => {
+ if (question.id === STACK_QUESTION_ID) {
+ responses[STACK_QUESTION_ID] = stackId
+ return
+ }
+
+ const defaultAnswers = question.answers.filter((answer) => answer.isDefault && !answer.disabled)
+
+ if (defaultAnswers.length === 0) {
+ return
+ }
+
+ autoFilledMap[question.id] = true
+
+ responses[question.id] = question.allowMultiple
+ ? defaultAnswers.map((answer) => answer.value)
+ : defaultAnswers[0]?.value
+ })
+ })
+
+ return { responses, autoFilledMap }
+}
+
+export const buildDefaultSummaryData = async (stackId: string): Promise => {
+ const { step, label } = await loadStackWizardStep(stackId)
+ const steps: WizardStep[] = [stacksStep, step, ...getSuffixSteps()]
+ const { responses, autoFilledMap } = buildDefaultsForSteps(steps, stackId)
+
+ return {
+ steps,
+ responses,
+ autoFilledMap,
+ stackLabel: label,
+ }
+}
+
+export const buildStepsForStack = async (stackId: string): Promise<{ steps: WizardStep[]; stackLabel: string }> => {
+ const { step, label } = await loadStackWizardStep(stackId)
+ return {
+ steps: [stacksStep, step, ...getSuffixSteps()],
+ stackLabel: label,
+ }
+}
diff --git a/lib/wizard-summary.ts b/lib/wizard-summary.ts
index 421f215..48029fb 100644
--- a/lib/wizard-summary.ts
+++ b/lib/wizard-summary.ts
@@ -55,11 +55,12 @@ export const buildCompletionSummary = (
selectedFileFormatLabel: string | null,
steps: WizardStep[],
responses: Responses,
- autoFilledMap: Record = {}
+ autoFilledMap: Record = {},
+ includeFileEntry = true
): CompletionSummaryEntry[] => {
- const summary: CompletionSummaryEntry[] = [
- buildFileSummaryEntry(fileQuestion, selectedFile, selectedFileFormatLabel),
- ]
+ const summary: CompletionSummaryEntry[] = includeFileEntry
+ ? [buildFileSummaryEntry(fileQuestion, selectedFile, selectedFileFormatLabel)]
+ : []
steps.forEach((step) => {
step.questions.forEach((question) => {
diff --git a/lib/wizard-utils.ts b/lib/wizard-utils.ts
index 37455b6..2310a6c 100644
--- a/lib/wizard-utils.ts
+++ b/lib/wizard-utils.ts
@@ -1,5 +1,28 @@
import type { DataAnswerSource, DataQuestionSource, FileOutputConfig, WizardAnswer, WizardStep } from "@/types/wizard"
+const buildFileSlug = (filename?: string, fallback?: string) => {
+ const base = filename ?? fallback ?? ""
+ const trimmed = base.trim()
+
+ if (!trimmed) {
+ return (fallback ?? "file").toLowerCase()
+ }
+
+ const withoutLeadingDot = trimmed.replace(/^\./, "")
+ const noExtension = withoutLeadingDot.replace(/\.[^./]+$/, "")
+ const normalizedSeparators = noExtension.replace(/[\\/]+/g, "-")
+ const collapsed = normalizedSeparators.replace(/[^a-zA-Z0-9]+/g, "-")
+ const hyphenReduced = collapsed.replace(/-+/g, "-")
+ const trimmedHyphen = hyphenReduced.replace(/^-|-$/g, "")
+
+ const slug = trimmedHyphen.toLowerCase()
+ if (slug.length === 0) {
+ return (fallback ?? "file").toLowerCase()
+ }
+
+ return slug
+}
+
/**
* Maps a data answer source to a wizard answer format
*/
@@ -69,6 +92,7 @@ export const buildFileOptionsFromQuestion = (
label: answer.label,
filename: answer.filename ?? answer.label,
format: answer.format ?? "markdown",
+ slug: buildFileSlug(answer.filename, answer.value ?? answer.label),
enabled: answer.enabled,
icon: answer.icon,
docs: answer.docs,
diff --git a/public/1758260486682rjzi0153.jpg b/public/1758260486682rjzi0153.jpg
deleted file mode 100644
index 4a297b8..0000000
Binary files a/public/1758260486682rjzi0153.jpg and /dev/null differ
diff --git a/public/icon-192x192.png b/public/icon-192x192.png
deleted file mode 100644
index c6280ab..0000000
Binary files a/public/icon-192x192.png and /dev/null differ
diff --git a/public/icon-512x512.png b/public/icon-512x512.png
deleted file mode 100644
index 6996329..0000000
Binary files a/public/icon-512x512.png and /dev/null differ
diff --git a/public/logo.png b/public/logo.png
index b84481d..37e4210 100644
Binary files a/public/logo.png and b/public/logo.png differ
diff --git a/public/logo3d.png b/public/logo3d.png
deleted file mode 100644
index 6fac04c..0000000
Binary files a/public/logo3d.png and /dev/null differ
diff --git a/types/wizard.ts b/types/wizard.ts
index 9acab45..5ce5c2e 100644
--- a/types/wizard.ts
+++ b/types/wizard.ts
@@ -30,6 +30,7 @@ export type FileOutputConfig = {
label: string
filename: string
format: string
+ slug: string
enabled?: boolean
icon?: string
docs?: string
@@ -68,12 +69,14 @@ export type WizardStep = {
questions: WizardQuestion[]
}
-export type WizardConfirmationIntent = "change-file" | "reset"
+export type WizardConfirmationIntent = "reset"
export type InstructionsWizardProps = {
- selectedFileId?: string | null
- onClose?: () => void
initialStackId?: string | null
+ onStackSelected?: (stackId: string, stackLabel?: string) => void
+ onStackCleared?: () => void
+ autoStartAfterStackSelection?: boolean
+ onComplete?: (stackId: string | null) => void
}
export type Responses = Record