create-win-project 1.3.0 → 1.4.0

package/{playbooks/platform/web.manifest.json → library/platforms/web/definition.json}

@@ -2,6 +2,7 @@
   "id": "web-platform",
   "kind": "platform",
   "label": "Web Platform",
+  "file": "platform/web.md",
   "appliesTo": { "platform": ["web"] },
   "deps": [],
   "devDeps": [],

package/{compatibility/profiles.json → library/tested-versions.json}

@@ -9,6 +9,8 @@
       "springModulith": "2.0.8",
       "runtimes": {
         "node": "24.20.0",
+        "nodeMinimum": "22.14.0",
+        "npmMinimum": "11.19.0",
         "java": "21",
         "maven": "3.9.16",
         "postgres": "16",
@@ -125,6 +127,8 @@
       "springModulith": "2.0.8",
       "runtimes": {
         "node": "24.20.0",
+        "nodeMinimum": "22.14.0",
+        "npmMinimum": "11.19.0",
         "java": "21",
         "maven": "3.9.16",
         "postgres": "16",

package/{playbooks/universal/accessibility.manifest.json → library/universal/accessibility/definition.json}

@@ -2,10 +2,10 @@
   "id": "accessibility-baseline",
   "kind": "universal",
   "label": "Accessibility Baseline",
+  "file": "universal/accessibility.md",
   "required": true,
   "folders": [],
   "concerns": [
     { "id": "accessibility", "required": true, "sections": ["Semantic Structure", "Keyboard and Focus", "Forms and Authentication", "Accessibility Testing"] }
   ]
 }
-

package/{playbooks/universal/coding-rules.manifest.json → library/universal/coding-rules/definition.json}

@@ -2,6 +2,7 @@
   "id": "coding-rules",
   "kind": "universal",
   "label": "Coding Rules",
+  "file": "universal/coding-rules.md",
   "required": true,
   "folders": [],
   "devDeps": ["prettier"],

package/{playbooks/universal/error-handling.manifest.json → library/universal/error-handling/definition.json}

@@ -2,6 +2,7 @@
   "id": "error-handling",
   "kind": "universal",
   "label": "Error Handling",
+  "file": "universal/error-handling.md",
   "required": true,
   "folders": [],
   "concerns": [

package/{playbooks/universal/git-conventions.manifest.json → library/universal/git-conventions/definition.json}

@@ -2,6 +2,7 @@
   "id": "git-conventions",
   "kind": "universal",
   "label": "Git Conventions",
+  "file": "universal/git-conventions.md",
   "required": true,
   "folders": [],
   "concerns": [

package/{playbooks/universal/observability.manifest.json → library/universal/observability/definition.json}

@@ -2,6 +2,7 @@
   "id": "observability-baseline",
   "kind": "universal",
   "label": "Observability Baseline",
+  "file": "universal/observability.md",
   "required": true,
   "folders": [],
   "concerns": [

package/{playbooks/universal/security.manifest.json → library/universal/security/definition.json}

@@ -2,6 +2,7 @@
   "id": "security-baseline",
   "kind": "universal",
   "label": "Security Baseline",
+  "file": "universal/security.md",
   "required": true,
   "folders": [],
   "concerns": [

package/{playbooks/universal/typescript.manifest.json → library/universal/typescript/definition.json}

@@ -2,6 +2,7 @@
   "id": "typescript",
   "kind": "universal",
   "label": "TypeScript",
+  "file": "universal/typescript.md",
   "required": true,
   "folders": [],
   "concerns": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-win-project",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Project scaffolding CLI by Win",
   "main": "index.js",
   "type": "module",
@@ -13,15 +13,15 @@
   },
   "files": [
     "index.js",
-    "lib",
-    "compatibility",
-    "playbooks",
-    "ci",
+    "src",
+    "library",
     "templates",
-    "scripts",
+    "checks",
+    "public/logo.svg",
     "docs/ARCHITECTURE.md",
     "docs/CONTENT_MODEL.md",
     "docs/DEPENDENCY_MAINTENANCE.md",
+    "docs/CONTRIBUTING.md",
     "README.md",
     "LICENSE"
   ],
@@ -29,13 +29,14 @@
     "start": "node index.js",
     "doctor": "node index.js doctor",
     "test": "vitest run",
-    "validate:content": "node scripts/validate-content.mjs",
-    "matrix:smoke": "node scripts/compatibility-matrix.mjs --scope=smoke",
-    "matrix:full": "node scripts/compatibility-matrix.mjs --scope=full",
-    "verify:generated": "node scripts/verify-generated.mjs"
+    "validate:content": "node checks/check-library.js",
+    "matrix:smoke": "node checks/check-compatibility.js --scope=smoke",
+    "matrix:full": "node checks/check-compatibility.js --scope=full",
+    "verify:generated": "node checks/check-generated-project.js"
   },
   "engines": {
-    "node": ">=24"
+    "node": ">=22.14",
+    "npm": ">=11.19"
   },
   "dependencies": {
     "chalk": "5.6.2",

package/public/logo.svg

@@ -0,0 +1,19 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 256 256" role="img" aria-label="W1N Project logo">
+<title>W1N Project logo</title>
+<style>
+  .bracket { fill: #ffffff; }
+  .accent { fill: #bdfa02; }
+</style>
+<circle cx="128" cy="128" r="128" fill="#0a0a0a" />
+<g class="brackets">
+  <path class="bracket" d="M 90.00 183.50 L 85.50 180.00 L 81.50 162.00 L 84.50 155.00 L 128.00 93.50 L 152.00 93.50 L 153.50 96.00 L 149.50 102.00 L 90.00 183.50 Z" />
+  <path class="bracket" d="M 59.00 162.50 L 46.00 162.50 L 12.50 130.00 L 12.50 126.00 L 46.00 93.50 L 59.00 93.50 L 60.50 102.00 L 34.50 128.00 L 60.50 154.00 L 59.00 162.50 Z" />
+  <path class="bracket" d="M 209.00 162.50 L 196.00 162.50 L 194.50 154.00 L 220.50 127.00 L 194.50 102.00 L 196.00 93.50 L 211.00 94.50 L 242.50 126.00 L 241.50 131.00 L 209.00 162.50 Z" />
+  <path class="bracket" d="M 82.00 151.50 L 79.50 151.00 L 78.50 147.00 L 64.50 79.00 L 64.50 74.00 L 67.00 71.50 L 86.00 71.50 L 89.50 75.00 L 100.50 124.00 L 82.00 151.50 Z" />
+  <path class="bracket" d="M 121.00 183.50 L 114.00 183.50 L 111.50 181.00 L 108.50 163.00 L 124.50 141.00 L 127.00 140.50 L 132.50 162.00 L 121.00 183.50 Z" />
+</g>
+<g class="accents">
+  <path class="accent" d="M 149.00 183.50 L 128.00 183.50 L 126.50 180.00 L 165.50 91.00 L 150.50 89.00 L 171.00 71.50 L 195.00 71.50 L 195.50 78.00 L 149.00 183.50 Z" />
+  <path class="accent" d="M 225.00 183.50 L 173.00 183.50 L 171.50 174.00 L 225.00 172.50 L 225.00 183.50 Z" />
+</g>
+</svg>

package/src/cli/arguments.js

@@ -0,0 +1,52 @@
+import { APPLICATION_SHAPES } from '../engine/project-shapes.js'
+import { laravelUis } from '../stacks/backends/laravel/ui/index.js'
+
+function option(args, name) {
+  return args.find((argument) => argument.startsWith(`--${name}=`))?.split('=')[1]
+}
+
+export function parseArguments(args) {
+  const profile = option(args, 'profile')
+  const shape = option(args, 'shape')
+  const frontendValue = option(args, 'frontend')
+  const frontendAliases = { vite: 'react', expo: 'react-native', none: 'no-frontend' }
+  const frontend = frontendAliases[frontendValue] || frontendValue
+  const backend = option(args, 'backend')
+  const architecture = option(args, 'architecture')
+  const authentication = option(args, 'authentication')
+  const authAudience = option(args, 'auth-audience')
+  const laravelUi = option(args, 'laravel-ui')
+  const install = args.includes('--install')
+  const noInstall = args.includes('--no-install')
+
+  if (shape && !APPLICATION_SHAPES[shape]) {
+    throw new Error('--shape must be fullstack, separate, api, mobile, or frontend')
+  }
+  if (architecture && !['small', 'medium', 'large'].includes(architecture)) {
+    throw new Error('--architecture must be small, medium, or large')
+  }
+  if (authentication && !['yes', 'not-yet', 'none'].includes(authentication)) {
+    throw new Error('--authentication must be yes, not-yet, or none')
+  }
+  if (authAudience && !['website', 'multi-client'].includes(authAudience)) {
+    throw new Error('--auth-audience must be website or multi-client')
+  }
+  if (laravelUi && !laravelUis.some((ui) => ui.id === laravelUi)) {
+    throw new Error('--laravel-ui must be blade, livewire, or inertia-react')
+  }
+  if (install && noInstall) throw new Error('Use either --install or --no-install, not both')
+
+  return Object.freeze({
+    profile,
+    shape,
+    frontend,
+    backend,
+    architecture,
+    authentication,
+    authAudience,
+    laravelUi,
+    install,
+    noInstall,
+    doctor: args[0] === 'doctor' || args.includes('--doctor'),
+  })
+}

package/src/cli/display.js

@@ -0,0 +1,220 @@
+import chalk from 'chalk'
+import ora from 'ora'
+import { APPLICATION_SHAPES } from '../engine/project-shapes.js'
+import path from 'node:path'
+
+// ─── Banner (from lib/banner.js) ────────────────────────────────────────────
+const W1N = [
+  ' ██╗    ██╗  ██╗ ███╗  ██╗',
+  ' ██║    ██║ ███║ ████╗ ██║',
+  ' ██║ █╗ ██║ ╚██║ ██╔██╗██║',
+  ' ██║███╗██║  ██║ ██║╚████║',
+  ' ╚███╔███╔╝  ██║ ██║ ╚███║',
+  '  ╚══╝╚══╝   ╚═╝ ╚═╝  ╚══╝',
+]
+const PROJECT = [
+  ' █▀█ █▀█ █▀█   █ █▀▀ █▀▀ ▀█▀',
+  ' █▀▀ █▀█ █ █   █ █▀  █    █ ',
+  ' █   █ █ █▄█ █▄█ █▄▄ █▄▄  █ ',
+]
+function plain() {
+  return [...W1N, '', ...PROJECT].join('\n')
+}
+function colored() {
+  const w1n = W1N.map((l) => chalk.bold.cyan(l)).join('\n')
+  const proj = PROJECT.map((l) => chalk.bold.white(l)).join('\n')
+  return `${w1n}\n${proj}`
+}
+export function w1nBanner() {
+  const noColor = process.env.NO_COLOR !== undefined || process.env.FORCE_COLOR === '0'
+  const isTTY = process.stdout.isTTY
+  const width = process.stdout.columns || 80
+  if (!isTTY || width < 80 || noColor) {
+    if (width < 60) return 'W1N PROJECT'
+    return plain()
+  }
+  return colored()
+}
+export const bannerRaw = plain()
+export const W1N_ART = W1N.join('\n')
+export const PROJECT_ART = PROJECT.join('\n')
+
+// ─── Project location (from src/engine/project-location.js) ─────────────────
+export function isInsideDirectory(candidate, parent) {
+  const relative = path.relative(path.resolve(parent), path.resolve(candidate))
+  return relative === '' || (!relative.startsWith('..') && !path.isAbsolute(relative))
+}
+export function projectLocationNotice({ cwd, cliRoot, projectName }) {
+  if (!isInsideDirectory(cwd, cliRoot)) return null
+  const generatedPath = path.join(path.resolve(cwd), projectName)
+  const suggestedPath = path.join(path.dirname(path.resolve(cliRoot)), projectName)
+  return {
+    generatedPath,
+    suggestedPath,
+    message: `This project was created inside the create-win-project repository. Move or cut the generated folder to your normal projects folder outside this repository before you start committing application work.`,
+  }
+}
+
+// ─── Display helpers ─────────────────────────────────────────────────────────
+export function printBanner(profile, output = console.log) {
+  output('')
+  output(w1nBanner())
+  output('')
+  output(chalk.gray('  Production-ready project scaffolding'))
+  output(chalk.gray(`  Compatibility profile: ${profile.id} (${profile.status})`))
+  output('')
+}
+
+export function printCancelled({ explainNoFiles = false } = {}, output = console.log) {
+  output(chalk.yellow(explainNoFiles ? '\n  Cancelled. No files were created.\n' : '\n  Cancelled.\n'))
+}
+
+export function startProjectSpinner() {
+  return ora('Scaffolding project...').start()
+}
+
+export function projectSucceeded(spinner) {
+  spinner.succeed(chalk.green('Project created!'))
+}
+
+export function startInstallSpinner() {
+  return ora('Installing exact dependencies and creating lockfiles...').start()
+}
+
+export function installSucceeded(spinner) {
+  spinner.succeed(chalk.green('Dependencies installed and lockfiles created.'))
+}
+
+export function installFailed(spinner) {
+  spinner.warn(chalk.yellow('Project created, but dependency installation did not finish.'))
+}
+
+export function generationFailed(spinner, error, report = console.error) {
+  spinner.fail(chalk.red('Failed to generate project'))
+  report(error)
+  report(chalk.yellow('Review the error above, correct the input or environment, then run create-win-project again.'))
+}
+
+export function printSummary({ answers, stack, catalog }, output = console.log) {
+  output('')
+  output(chalk.cyan.bold('  Review before creating files'))
+  output(chalk.gray('  ───────────────────────────'))
+  output(`  ${chalk.cyan('Name:')}         ${answers.projectName}`)
+  output(`  ${chalk.cyan('Stack:')}        ${stack.label}`)
+  output(`  ${chalk.cyan('Shape:')}        ${APPLICATION_SHAPES[stack.applicationShape].label}`)
+  output(`  ${chalk.cyan('Platform:')}     ${stack.platform}`)
+  if (stack.styleId) output(`  ${chalk.cyan('Styling:')}      ${catalog.byId[stack.styleId]?.label || stack.styleId}`)
+  if (answers.laravelUi) output(`  ${chalk.cyan('Laravel UI:')}   ${answers.laravelUi}`)
+  output(`  ${chalk.cyan('Architecture:')} ${stack.architecture[0].toUpperCase()}${stack.architecture.slice(1)}`)
+  output(`  ${chalk.cyan('Authentication:')} ${stack.authentication}`)
+  output(`  ${chalk.cyan('Testing:')}      ${answers.testing}`)
+  if (stack.platform !== 'mobile') {
+    output(`  ${chalk.cyan('Docker:')}       ${answers.docker ? 'yes' : 'no'}`)
+    output(`  ${chalk.cyan('Makefile:')}     ${answers.makefile ? 'yes' : 'no'}`)
+  }
+  output(`  ${chalk.cyan('CI/CD:')}        ${answers.githubActions ? 'yes' : 'no'}`)
+  output(`  ${chalk.cyan('Install deps:')} ${answers.installDependencies ? 'yes' : 'no'}`)
+  if (answers.packageName) output(`  ${chalk.cyan('Package:')}      ${answers.packageName}`)
+  if (stack.constraints.length) {
+    output('')
+    output(chalk.gray('  Key constraints:'))
+    for (const rule of stack.constraints.slice(0, 3)) output(chalk.gray(`  • ${rule}`))
+  }
+  output('')
+}
+
+export function printRuntimeMismatch(issues, output = console.log) {
+  output(chalk.yellow.bold('\n  Runtime mismatch\n'))
+  for (const issue of issues) {
+    output(chalk.yellow(`  ${issue.tool} ${issue.required} or newer is required.`))
+    output(chalk.gray(`  Current terminal: ${issue.tool} ${issue.found || 'not found'}.`))
+  }
+  output(chalk.gray('\n  Your global tools will not be changed.\n'))
+}
+
+export function printRuntimeInstructions(lines, output = console.log) {
+  output(chalk.cyan.bold('\n  Runtime setup\n'))
+  for (const line of lines) output(chalk.gray(`  ${line}`))
+  output(chalk.gray('\n  Run create-win-project again after switching runtimes.\n'))
+}
+
+export function printRuntimeSkip(issues, output = console.log) {
+  output(chalk.yellow('\n  Dependency installation will be skipped because this terminal does not meet the selected project requirements.'))
+  for (const issue of issues) output(chalk.gray(`  ${issue.tool}: ${issue.found || 'not found'} (requires ${issue.required} or newer)`))
+  output(chalk.gray('  Project files will still be created. Use Mise/NVM, then run the retry command shown below.\n'))
+}
+
+export function printLocationNotice(notice, output = console.log) {
+  if (!notice) return
+  output('')
+  output(chalk.yellow.bold('  Project location note'))
+  output(chalk.yellow(`  ${notice.message}`))
+  output(chalk.gray(`  Created at: ${notice.generatedPath}`))
+  output(chalk.gray(`  Suggested destination: ${notice.suggestedPath}`))
+  output(chalk.gray(`  Linux/macOS: mv "${notice.generatedPath}" "${notice.suggestedPath}"`))
+  output(chalk.gray('  Windows: cut the generated folder in File Explorer and paste it into your projects folder.'))
+}
+
+function detectedLine(versions) {
+  return `  Detected Node.js ${versions.node || 'not found'}, npm ${versions.npm || 'not found'}, PHP ${versions.php || 'not found'}, and Composer ${versions.composer || 'not found'}.`
+}
+
+export function printInstallFailure(versions, retry, output = console.log) {
+  output(chalk.yellow(detectedLine(versions)))
+  output(chalk.yellow(`  Retry with: ${retry}`))
+}
+
+export function printInstallSkipped(versions, steps, output = console.log) {
+  output(chalk.yellow('  Project files were created without installing dependencies.'))
+  output(chalk.gray(detectedLine(versions)))
+  for (const step of steps) output(chalk.gray(`  Retry with: ${step.retry}`))
+}
+
+export function printNextSteps(answers, stack, output = console.log) {
+  output('')
+  output(chalk.bold('  Next steps:'))
+  output(chalk.gray(`  cd ${answers.projectName}`))
+  if (stack.backendKey === 'laravel') {
+    const laravelDir = ['laravel-ui', 'no-frontend'].includes(stack.frontendKey) ? '' : 'backend/'
+    output(chalk.gray(`  cp ${laravelDir}.env.example ${laravelDir}.env`))
+    if (answers.makefile) {
+      output(chalk.gray('  make setup  # first run only'))
+      output(chalk.gray('  make run    # later runs; never rebuilds'))
+    } else {
+      output(chalk.gray('  docker compose build'))
+      output(chalk.gray('  docker compose up -d'))
+    }
+  } else if (stack.frontendKey === 'react') {
+    if (stack.backendKey === 'springboot') output(chalk.gray('  cp .env.example .env  # Docker/backend values'))
+    output(chalk.gray('  cd frontend'))
+    output(chalk.gray('  cp .env.example .env'))
+    if (!answers.installDependencies) output(chalk.gray('  npm install'))
+  } else {
+    output(chalk.gray(`  cp .env.example ${stack.isMobile ? '.env' : '.env.local'}`))
+    if (!answers.installDependencies) output(chalk.gray('  npm install'))
+  }
+  if (stack.backendKey !== 'laravel') {
+    if (stack.isMobile) output(chalk.gray('  npx expo start'))
+    else if (answers.makefile) {
+      if (stack.frontendKey === 'react') output(chalk.gray('  cd ..'))
+      output(chalk.gray('  make dev'))
+    } else if (stack.backendKey === 'supabase') {
+      output(chalk.gray('  npm run supabase:start'))
+      output(chalk.gray('  npm run dev'))
+    } else if (stack.frontendKey === 'react') output(chalk.gray('  npm run dev'))
+    else {
+      output(chalk.gray('  docker compose up -d db'))
+      output(chalk.gray('  npm run dev'))
+    }
+  }
+  output('')
+  output(chalk.cyan('  Read RULES.md before starting — it maps every playbook for this stack.'))
+  output('')
+}
+
+export function printSupportPrompt(output = console.log) {
+  output(chalk.gray('  ───────────────────────────'))
+  output(chalk.gray('  Enjoyed this starter? ⭐ Star https://github.com/itsw1n/create-win-project'))
+  output(chalk.gray('  Found a gap or idea? Open an issue: https://github.com/itsw1n/create-win-project/issues/new'))
+  output('')
+}

package/src/cli/main.js

@@ -0,0 +1,185 @@
+import inquirer from 'inquirer'
+import path from 'path'
+import { fileURLToPath } from 'url'
+import { generateProject } from '../engine/create-project.js'
+import { runDependencySteps } from '../engine/install-dependencies.js'
+import { loadCompatibility } from '../engine/tested-versions.js'
+import { buildQuestions, configurationDecisionChoices, lastEnabledIndex, promptWithBack } from './questions.js'
+import {
+  printBanner,
+  generationFailed,
+  installFailed,
+  installSucceeded,
+  printInstallFailure,
+  printInstallSkipped,
+  printLocationNotice,
+  printNextSteps,
+  printSupportPrompt,
+  printCancelled,
+  printRuntimeInstructions,
+  printRuntimeMismatch,
+  printRuntimeSkip,
+  printSummary,
+  projectSucceeded,
+  projectLocationNotice,
+  startInstallSpinner,
+  startProjectSpinner,
+} from './display.js'
+import { parseArguments } from './arguments.js'
+import {
+  loadCatalog, resolveStack,
+} from '../engine/load-library.js'
+import {
+  decideInstallation,
+  detectSystemVersions,
+  installationIssues,
+  runtimeSetupInstructions,
+  printDoctor,
+} from './system-check.js'
+
+const cliDirectory = path.dirname(fileURLToPath(import.meta.url))
+const projectRoot = path.resolve(cliDirectory, '../..')
+
+export async function runCli() {
+const args = parseArguments(process.argv.slice(2))
+const profileArg = args.profile
+const shapeArg = args.shape
+const frontendArg = args.frontend
+const backendArg = args.backend
+const architectureArg = args.architecture
+const authenticationArg = args.authentication
+const authAudienceArg = args.authAudience
+const laravelUiArg = args.laravelUi
+const wantsInstall = args.install
+const skipsInstall = args.noInstall
+const { profile } = await loadCompatibility(
+  path.join(projectRoot, 'library/tested-versions.json'),
+  profileArg,
+)
+if (args.doctor) {
+  printDoctor(profile)
+  process.exit(0)
+}
+const catalog = await loadCatalog(path.join(projectRoot, 'library'), profile)
+
+// ─── Banner ──────────────────────────────────────────────────────────────────
+
+printBanner(profile)
+
+// ─── Interview ───────────────────────────────────────────────────────────────
+
+const questions = buildQuestions({ args, catalog })
+let answers = {
+  applicationShape: shapeArg,
+  frontend: frontendArg,
+  backend: backendArg,
+}
+let stack
+let resumeAt = 0
+while (true) {
+answers = await promptWithBack(inquirer, questions, answers, resumeAt)
+resumeAt = 0
+answers.compatibilityProfile = profile.id
+answers.applicationShape = shapeArg || answers.applicationShape
+answers.architecture = architectureArg || answers.architecture || 'medium'
+answers.authentication = authenticationArg || answers.authentication || 'not-yet'
+answers.authAudience = authAudienceArg || answers.authAudience || (catalog.byId[answers.frontend]?.platform === 'mobile' ? 'multi-client' : 'website')
+answers.laravelUi = laravelUiArg || answers.laravelUi || (answers.frontend === 'laravel-ui' ? 'blade' : undefined)
+if (wantsInstall) answers.installDependencies = true
+if (skipsInstall) answers.installDependencies = false
+
+stack = resolveStack({ ...answers, styling: answers.styling || catalog.byId[answers.frontend]?.stylingOptions?.[0] || 'tailwind' }, catalog)
+
+// ─── Confirm ─────────────────────────────────────────────────────────────────
+
+printSummary({ answers, stack, catalog })
+
+const { decision } = await inquirer.prompt([{
+  type: 'list', name: 'decision', message: 'Ready?', choices: configurationDecisionChoices(),
+}])
+
+if (decision === 'back') {
+  resumeAt = lastEnabledIndex(questions, answers)
+  continue
+}
+if (decision === 'cancel') {
+  printCancelled()
+  process.exit(0)
+}
+break
+}
+
+const detectedVersions = detectSystemVersions()
+const runtimeIssues = installationIssues(stack, profile, detectedVersions)
+const installationDecision = await decideInstallation({
+  requested: answers.installDependencies,
+  issues: runtimeIssues,
+  interactive: Boolean(process.stdin.isTTY && process.stdout.isTTY),
+  choose: async () => {
+    printRuntimeMismatch(runtimeIssues)
+    const { runtimeDecision } = await inquirer.prompt([{
+      type: 'list',
+      name: 'runtimeDecision',
+      message: 'How should create-win-project continue?',
+      choices: [
+        { name: 'Create files and skip dependency installation', value: 'skip' },
+        { name: 'Show runtime setup instructions', value: 'instructions' },
+        { name: 'Cancel', value: 'cancel' },
+      ],
+    }])
+    return runtimeDecision
+  },
+})
+
+if (installationDecision.reason === 'cancelled') {
+  printCancelled({ explainNoFiles: true })
+  process.exit(0)
+}
+if (installationDecision.reason === 'show-instructions') {
+  printRuntimeInstructions(runtimeSetupInstructions(profile, runtimeIssues))
+  process.exit(0)
+}
+if (answers.installDependencies && !installationDecision.install) {
+  printRuntimeSkip(runtimeIssues)
+}
+answers.installDependencies = installationDecision.install
+
+// ─── Generate ────────────────────────────────────────────────────────────────
+
+const spinner = startProjectSpinner()
+
+try {
+  await generateProject(answers, projectRoot)
+  projectSucceeded(spinner)
+  const generatedProjectRoot = path.join(process.cwd(), answers.projectName)
+  const steps = []
+  if (stack.backendKey === 'laravel') {
+    const laravelRoot = ['laravel-ui', 'no-frontend'].includes(stack.frontendKey) ? generatedProjectRoot : path.join(generatedProjectRoot, 'backend')
+    steps.push({ command: process.platform === 'win32' ? 'composer.bat' : 'composer', args: ['install'], cwd: laravelRoot, retry: `cd ${path.relative(process.cwd(), laravelRoot)} && composer install` })
+  }
+  const needsNpm = stack.frontendKey !== 'no-frontend' && (stack.frontendKey !== 'laravel-ui' || answers.laravelUi === 'inertia-react')
+  if (needsNpm) {
+    const npmRoot = stack.frontendKey === 'react' ? path.join(generatedProjectRoot, 'frontend') : generatedProjectRoot
+    steps.push({ command: process.platform === 'win32' ? 'npm.cmd' : 'npm', args: ['install'], cwd: npmRoot, retry: `cd ${path.relative(process.cwd(), npmRoot)} && npm install` })
+  }
+  const locationNotice = projectLocationNotice({ cwd: process.cwd(), cliRoot: projectRoot, projectName: answers.projectName })
+  printLocationNotice(locationNotice)
+  if (answers.installDependencies) {
+    const installSpinner = startInstallSpinner()
+    const { failed } = runDependencySteps(steps)
+    if (failed) {
+      installFailed(installSpinner)
+      printInstallFailure(detectedVersions, failed.retry)
+    } else {
+      installSucceeded(installSpinner)
+    }
+  } else if (installationDecision.reason === 'runtime-mismatch') {
+    printInstallSkipped(detectedVersions, steps)
+  }
+  printNextSteps(answers, stack)
+  if (process.stdout.isTTY) printSupportPrompt()
+} catch (err) {
+  generationFailed(spinner, err)
+  process.exit(1)
+}
+}