reset-framework-cli 1.1.1 → 1.1.4

package/src/commands/init.js

@@ -1,931 +1,936 @@
-import { existsSync, readdirSync } from "node:fs"
-import { cp, mkdir, readFile, readdir, writeFile } from "node:fs/promises"
-import path from "node:path"
-
-import {
-  captureCommandOutput,
-  getInstallCommandArgs,
-  resolvePackageManagerCommand,
-  runCommand
-} from "../lib/process.js"
-import {
-  makeAppMetadata,
-  resolveCliDependencySpec,
-  resolveFrameworkPaths,
-  resolveSdkDependencySpec
-} from "../lib/project.js"
-import {
-  createProgress,
-  isInteractiveSession,
-  printBanner,
-  printKeyValueTable,
-  printSection,
-  printStatusTable,
-  promptConfirm,
-  promptSelect,
-  promptText,
-  withPromptSession
-} from "../lib/ui.js"
-
-const sdkRuntimeReexport = `export * from '@reset-framework/sdk'
-`
-
-const standaloneViteConfig = `import { defineConfig } from 'vite'
-import react from '@vitejs/plugin-react'
-
-export default defineConfig({
-  base: './',
-  plugins: [react()],
-})
-`
-
-const tailwindViteConfig = `import { defineConfig } from 'vite'
-import react from '@vitejs/plugin-react'
-import tailwindcss from '@tailwindcss/vite'
-
-export default defineConfig({
-  base: './',
-  plugins: [react(), tailwindcss()],
-})
-`
-
-const standaloneTsconfigApp = `{
-  "compilerOptions": {
-    "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.app.tsbuildinfo",
-    "target": "ES2023",
-    "useDefineForClassFields": true,
-    "lib": ["ES2023", "DOM", "DOM.Iterable"],
-    "module": "ESNext",
-    "types": ["vite/client"],
-    "skipLibCheck": true,
-    "moduleResolution": "bundler",
-    "allowImportingTsExtensions": true,
-    "verbatimModuleSyntax": true,
-    "moduleDetection": "force",
-    "noEmit": true,
-    "jsx": "react-jsx",
-    "strict": true,
-    "noUnusedLocals": true,
-    "noUnusedParameters": true,
-    "erasableSyntaxOnly": true,
-    "noFallthroughCasesInSwitch": true,
-    "noUncheckedSideEffectImports": true
-  },
-  "include": ["src"]
-}
-`
-
-const tailwindIndexCss = `@import "tailwindcss";
-
-:root {
-  color-scheme: dark;
-}
-
-body {
-  margin: 0;
-  font-family: "Avenir Next", "Segoe UI", sans-serif;
-  background: #111111;
-}
-`
-
-const tailwindAppTsx = `import { useEffect, useState } from 'react'
-import { reset } from './lib/reset'
-
-function App() {
-  const [count, setCount] = useState(0)
-  const [appName, setAppName] = useState('Reset App')
-  const [appVersion, setAppVersion] = useState('0.0.0')
-  const [platform, setPlatform] = useState('unknown')
-  const [bridgeVersion, setBridgeVersion] = useState('1')
-
-  useEffect(() => {
-    let cancelled = false
-
-    async function loadRuntimeInfo() {
-      try {
-        const [appInfo, runtimeInfo] = await Promise.all([
-          reset.app.getInfo(),
-          reset.runtime.getInfo(),
-        ])
-
-        if (cancelled) {
-          return
-        }
-
-        setAppName(appInfo.name)
-        setAppVersion(appInfo.version)
-        setPlatform(runtimeInfo.platform)
-        setBridgeVersion(runtimeInfo.bridgeVersion)
-      } catch (error) {
-        console.error('Failed to load runtime info', error)
-      }
-    }
-
-    loadRuntimeInfo()
-
-    return () => {
-      cancelled = true
-    }
-  }, [])
-
-  return (
-    <main className="min-h-screen bg-stone-950 text-stone-100">
-      <div className="mx-auto flex min-h-screen max-w-6xl flex-col px-6 py-12 lg:px-10">
-        <div className="inline-flex w-fit items-center rounded-full border border-white/10 bg-white/5 px-4 py-2 text-sm tracking-[0.18em] text-stone-300 uppercase">
-          {appName} v{appVersion} on {platform}
-        </div>
-
-        <div className="mt-12 grid gap-12 lg:grid-cols-[minmax(0,1.4fr)_minmax(20rem,0.8fr)] lg:items-end">
-          <section>
-            <p className="text-sm font-medium uppercase tracking-[0.32em] text-amber-300">
-              Reset Framework
-            </p>
-            <h1 className="mt-5 max-w-4xl text-5xl font-medium leading-[0.95] tracking-[-0.06em] text-white sm:text-6xl lg:text-7xl">
-              Tailwind-ready desktop apps with a native runtime underneath.
-            </h1>
-            <p className="mt-6 max-w-2xl text-lg leading-8 text-stone-300">
-              Edit the frontend, call native commands through the runtime bridge, and keep the
-              host layer out of the way while you build the actual product.
-            </p>
-          </section>
-
-          <section className="rounded-[2rem] border border-white/10 bg-white/5 p-6 shadow-2xl shadow-black/20 backdrop-blur">
-            <div className="flex items-center justify-between text-sm text-stone-400">
-              <span>Runtime bridge</span>
-              <span>bridge v{bridgeVersion}</span>
-            </div>
-            <div className="mt-6 rounded-2xl border border-white/10 bg-black/30 p-5">
-              <div className="text-xs uppercase tracking-[0.24em] text-stone-500">
-                Counter
-              </div>
-              <div className="mt-4 text-4xl font-semibold text-white">{count}</div>
-              <button
-                className="mt-6 inline-flex items-center rounded-full bg-amber-300 px-5 py-3 text-sm font-semibold text-stone-950 transition hover:bg-amber-200"
-                onClick={() => setCount((value) => value + 1)}
-              >
-                Increment
-              </button>
-            </div>
-          </section>
-        </div>
-      </div>
-    </main>
-  )
-}
-
-export default App
-`
-
-const rootFrontendRunner = `import { readFileSync } from 'node:fs'
-import path from 'node:path'
-import { spawn } from 'node:child_process'
-
-const script = process.argv[2]
-if (!script) {
-  throw new Error('Missing frontend script name.')
-}
-
-const appRoot = process.cwd()
-const config = JSON.parse(readFileSync(path.join(appRoot, 'reset.config.json'), 'utf8'))
+import { existsSync, readdirSync } from "node:fs"
+import { cp, mkdir, readFile, readdir, writeFile } from "node:fs/promises"
+import path from "node:path"
+
+import {
+  captureCommandOutput,
+  getInstallCommandArgs,
+  resolvePackageManagerCommand,
+  runCommand
+} from "../lib/process.js"
+import {
+  makeAppMetadata,
+  resolveCliDependencySpec,
+  resolveFrameworkPaths,
+  resolveSdkDependencySpec
+} from "../lib/project.js"
+import {
+  createProgress,
+  isInteractiveSession,
+  printBanner,
+  printKeyValueTable,
+  printSection,
+  printStatusTable,
+  promptConfirm,
+  promptSelect,
+  promptText,
+  withPromptSession
+} from "../lib/ui.js"
+
+const sdkRuntimeReexport = `export * from '@reset-framework/sdk'
+`
+
+const standaloneViteConfig = `import { defineConfig } from 'vite'
+import react from '@vitejs/plugin-react'
+
+export default defineConfig({
+  base: './',
+  plugins: [react()],
+})
+`
+
+const tailwindViteConfig = `import { defineConfig } from 'vite'
+import react from '@vitejs/plugin-react'
+import tailwindcss from '@tailwindcss/vite'
+
+export default defineConfig({
+  base: './',
+  plugins: [react(), tailwindcss()],
+})
+`
+
+const standaloneTsconfigApp = `{
+  "compilerOptions": {
+    "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.app.tsbuildinfo",
+    "target": "ES2023",
+    "useDefineForClassFields": true,
+    "lib": ["ES2023", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "types": ["vite/client"],
+    "skipLibCheck": true,
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "verbatimModuleSyntax": true,
+    "moduleDetection": "force",
+    "noEmit": true,
+    "jsx": "react-jsx",
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "erasableSyntaxOnly": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedSideEffectImports": true
+  },
+  "include": ["src"]
+}
+`
+
+const tailwindIndexCss = `@import "tailwindcss";
+
+:root {
+  color-scheme: dark;
+}
+
+body {
+  margin: 0;
+  font-family: "Avenir Next", "Segoe UI", sans-serif;
+  background: #111111;
+}
+`
+
+const tailwindAppTsx = `import { useEffect, useState } from 'react'
+import { reset } from './lib/reset'
+
+function App() {
+  const [count, setCount] = useState(0)
+  const [appName, setAppName] = useState('Reset App')
+  const [appVersion, setAppVersion] = useState('0.0.0')
+  const [platform, setPlatform] = useState('unknown')
+  const [bridgeVersion, setBridgeVersion] = useState('1')
+
+  useEffect(() => {
+    let cancelled = false
+
+    async function loadRuntimeInfo() {
+      try {
+        const [appInfo, runtimeInfo] = await Promise.all([
+          reset.app.getInfo(),
+          reset.runtime.getInfo(),
+        ])
+
+        if (cancelled) {
+          return
+        }
+
+        setAppName(appInfo.name)
+        setAppVersion(appInfo.version)
+        setPlatform(runtimeInfo.platform)
+        setBridgeVersion(runtimeInfo.bridgeVersion)
+      } catch (error) {
+        console.error('Failed to load runtime info', error)
+      }
+    }
+
+    loadRuntimeInfo()
+
+    return () => {
+      cancelled = true
+    }
+  }, [])
+
+  return (
+    <main className="min-h-screen bg-stone-950 text-stone-100">
+      <div className="mx-auto flex min-h-screen max-w-6xl flex-col px-6 py-12 lg:px-10">
+        <div className="inline-flex w-fit items-center rounded-full border border-white/10 bg-white/5 px-4 py-2 text-sm tracking-[0.18em] text-stone-300 uppercase">
+          {appName} v{appVersion} on {platform}
+        </div>
+
+        <div className="mt-12 grid gap-12 lg:grid-cols-[minmax(0,1.4fr)_minmax(20rem,0.8fr)] lg:items-end">
+          <section>
+            <p className="text-sm font-medium uppercase tracking-[0.32em] text-amber-300">
+              Reset Framework
+            </p>
+            <h1 className="mt-5 max-w-4xl text-5xl font-medium leading-[0.95] tracking-[-0.06em] text-white sm:text-6xl lg:text-7xl">
+              Tailwind-ready desktop apps with a native runtime underneath.
+            </h1>
+            <p className="mt-6 max-w-2xl text-lg leading-8 text-stone-300">
+              Edit the frontend, call native commands through the runtime bridge, and keep the
+              host layer out of the way while you build the actual product.
+            </p>
+          </section>
+
+          <section className="rounded-[2rem] border border-white/10 bg-white/5 p-6 shadow-2xl shadow-black/20 backdrop-blur">
+            <div className="flex items-center justify-between text-sm text-stone-400">
+              <span>Runtime bridge</span>
+              <span>bridge v{bridgeVersion}</span>
+            </div>
+            <div className="mt-6 rounded-2xl border border-white/10 bg-black/30 p-5">
+              <div className="text-xs uppercase tracking-[0.24em] text-stone-500">
+                Counter
+              </div>
+              <div className="mt-4 text-4xl font-semibold text-white">{count}</div>
+              <button
+                className="mt-6 inline-flex items-center rounded-full bg-amber-300 px-5 py-3 text-sm font-semibold text-stone-950 transition hover:bg-amber-200"
+                onClick={() => setCount((value) => value + 1)}
+              >
+                Increment
+              </button>
+            </div>
+          </section>
+        </div>
+      </div>
+    </main>
+  )
+}
+
+export default App
+`
+
+const rootFrontendRunner = `import { readFileSync } from 'node:fs'
+import path from 'node:path'
+import { spawn } from 'node:child_process'
+
+const script = process.argv[2]
+if (!script) {
+  throw new Error('Missing frontend script name.')
+}
+
+const appRoot = process.cwd()
+const config = JSON.parse(readFileSync(path.join(appRoot, 'reset.config.json'), 'utf8'))
 const frontendDir =
   typeof config?.project?.frontendDir === 'string' && config.project.frontendDir.trim() !== ''
     ? path.resolve(appRoot, config.project.frontendDir)
     : path.join(appRoot, 'frontend')
 
-function resolvePackageManagerCommand() {
-  const packageJsonPath = path.join(appRoot, 'package.json')
-  const manifest = JSON.parse(readFileSync(packageJsonPath, 'utf8'))
-  const packageManager = typeof manifest.packageManager === 'string' ? manifest.packageManager.trim() : ''
-  const name = packageManager.split('@')[0]
-
-  if (name === 'bun') {
-    return process.platform === 'win32' ? 'bun.exe' : 'bun'
-  }
-
-  if (name === 'pnpm') {
-    return process.platform === 'win32' ? 'pnpm.cmd' : 'pnpm'
-  }
-
-  if (name === 'yarn') {
-    return process.platform === 'win32' ? 'yarn.cmd' : 'yarn'
-  }
-
-  if (name === 'npm') {
-    return process.platform === 'win32' ? 'npm.cmd' : 'npm'
-  }
-
-  const candidates = [
-    ['bun.lock', process.platform === 'win32' ? 'bun.exe' : 'bun'],
-    ['bun.lockb', process.platform === 'win32' ? 'bun.exe' : 'bun'],
-    ['pnpm-lock.yaml', process.platform === 'win32' ? 'pnpm.cmd' : 'pnpm'],
-    ['yarn.lock', process.platform === 'win32' ? 'yarn.cmd' : 'yarn'],
-    ['package-lock.json', process.platform === 'win32' ? 'npm.cmd' : 'npm']
-  ]
-
-  for (const [fileName, command] of candidates) {
-    try {
-      readFileSync(path.join(appRoot, fileName), 'utf8')
-      return command
-    } catch {}
-  }
-
-  return process.platform === 'win32' ? 'npm.cmd' : 'npm'
+function shouldUseShell(command) {
+  return process.platform === 'win32' && typeof command === 'string' && /\\.(cmd|bat)$/i.test(command)
 }
-
+
+function resolvePackageManagerCommand() {
+  const packageJsonPath = path.join(appRoot, 'package.json')
+  const manifest = JSON.parse(readFileSync(packageJsonPath, 'utf8'))
+  const packageManager = typeof manifest.packageManager === 'string' ? manifest.packageManager.trim() : ''
+  const name = packageManager.split('@')[0]
+
+  if (name === 'bun') {
+    return process.platform === 'win32' ? 'bun.exe' : 'bun'
+  }
+
+  if (name === 'pnpm') {
+    return process.platform === 'win32' ? 'pnpm.cmd' : 'pnpm'
+  }
+
+  if (name === 'yarn') {
+    return process.platform === 'win32' ? 'yarn.cmd' : 'yarn'
+  }
+
+  if (name === 'npm') {
+    return process.platform === 'win32' ? 'npm.cmd' : 'npm'
+  }
+
+  const candidates = [
+    ['bun.lock', process.platform === 'win32' ? 'bun.exe' : 'bun'],
+    ['bun.lockb', process.platform === 'win32' ? 'bun.exe' : 'bun'],
+    ['pnpm-lock.yaml', process.platform === 'win32' ? 'pnpm.cmd' : 'pnpm'],
+    ['yarn.lock', process.platform === 'win32' ? 'yarn.cmd' : 'yarn'],
+    ['package-lock.json', process.platform === 'win32' ? 'npm.cmd' : 'npm']
+  ]
+
+  for (const [fileName, command] of candidates) {
+    try {
+      readFileSync(path.join(appRoot, fileName), 'utf8')
+      return command
+    } catch {}
+  }
+
+  return process.platform === 'win32' ? 'npm.cmd' : 'npm'
+}
+
 const command = resolvePackageManagerCommand()
 const child = spawn(command, ['run', script, '--', ...process.argv.slice(3)], {
   cwd: frontendDir,
   stdio: 'inherit',
-  env: process.env
-})
-
-child.once('error', (error) => {
-  console.error(error)
-  process.exit(1)
+  env: process.env,
+  shell: shouldUseShell(command)
 })
-
-child.once('exit', (code, signal) => {
-  if (signal) {
-    process.kill(process.pid, signal)
-    return
-  }
-
-  process.exit(code ?? 1)
-})
-`
-
-export const description = "Scaffold a starter app with an interactive project setup"
-
-function listTemplates(templatesDir) {
-  return readdirSync(templatesDir, { withFileTypes: true })
-    .filter((entry) => entry.isDirectory())
-    .map((entry) => entry.name)
-    .sort()
-}
-
-function getRootGitignore(frontendDir) {
-  if (frontendDir === ".") {
-    return `.DS_Store
-Thumbs.db
-.idea/
-.vs/
-.vscode/
-.cache/
-.reset/
-.turbo/
-build/
-coverage/
-dist/
-node_modules/
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-.pnpm-debug.log*
-*.log
-*.zip
-*.tgz
-*.tsbuildinfo
-*.dSYM/
-.env
-.env.*
-.env.local
-.env.*.local
-.eslintcache
-bun.lock
-bun.lockb
-compile_commands.json
-CMakeUserPresets.json
-CMakeCache.txt
-CMakeFiles/
-cmake_install.cmake
-install_manifest.txt
-cmake-build-*/
-Testing/
-scripts/local/
-`
-  }
-
-  return `.DS_Store
-Thumbs.db
-.idea/
-.vs/
-.vscode/
-.cache/
-.reset/
-.turbo/
-build/
-coverage/
-node_modules/
-${frontendDir}/node_modules/
-${frontendDir}/dist/
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-.pnpm-debug.log*
-*.log
-*.zip
-*.tgz
-*.tsbuildinfo
-*.dSYM/
-.env
-.env.*
-.env.local
-.env.*.local
-.eslintcache
-bun.lock
-bun.lockb
-compile_commands.json
-CMakeUserPresets.json
-CMakeCache.txt
-CMakeFiles/
-cmake_install.cmake
-install_manifest.txt
-cmake-build-*/
-Testing/
-scripts/local/
-`
-}
-
-function resolveDefaultFrontendDir(context) {
-  if (typeof context.flags["frontend-dir"] === "string") {
-    return context.flags["frontend-dir"]
-  }
-
-  if (context.flags.flat) {
-    return "."
-  }
-
-  return "frontend"
-}
-
-function resolveDefaultStyling(context) {
-  if (context.flags.tailwind) {
-    return "tailwindcss"
-  }
-
-  if (context.flags["no-tailwind"]) {
-    return "css"
-  }
-
-  return "css"
-}
-
-function resolvePackageManagerOption(context) {
-  if (typeof context.flags["package-manager"] === "string") {
-    return context.flags["package-manager"]
-  }
-
-  return "npm"
-}
-
-function describeInstallCommand(packageManager) {
-  return [packageManager, ...getInstallCommandArgs(packageManager)].join(" ")
-}
-
-async function ensureWritableTarget(targetDir, force) {
-  if (!existsSync(targetDir)) {
-    return
-  }
-
-  const entries = await readdir(targetDir)
-
-  if (entries.length > 0 && !force) {
-    throw new Error(`Target directory is not empty: ${targetDir}. Use --force to continue.`)
-  }
-}
-
-async function copyFrontendTemplate(sourceFrontendDir, targetFrontendDir, options) {
-  const { force, frontendDir } = options
-  const flatLayout = frontendDir === "."
-
-  if (!flatLayout) {
-    await cp(sourceFrontendDir, targetFrontendDir, {
-      recursive: true,
-      force,
-      filter(source) {
-        const baseName = path.basename(source)
-        return (
-          baseName !== "node_modules" &&
-          baseName !== "dist" &&
-          baseName !== "bun.lockb" &&
-          baseName !== "reset.config.json"
-        )
-      }
-    })
-
-    return
-  }
-
-  await mkdir(targetFrontendDir, { recursive: true })
-
-  const entries = await readdir(sourceFrontendDir, { withFileTypes: true })
-  for (const entry of entries) {
-    if (["node_modules", "dist", "bun.lockb", "reset.config.json", ".gitignore", "README.md"].includes(entry.name)) {
-      continue
-    }
-
-    await cp(
-      path.join(sourceFrontendDir, entry.name),
-      path.join(targetFrontendDir, entry.name),
-      { recursive: true, force }
-    )
-  }
-}
-
-async function applyFrontendOverrides(frontendDir, options) {
-  await writeFile(path.join(frontendDir, "src", "lib", "reset.ts"), sdkRuntimeReexport, "utf8")
-  await writeFile(path.join(frontendDir, "tsconfig.app.json"), standaloneTsconfigApp, "utf8")
-
-  const packageJsonPath = path.join(frontendDir, "package.json")
-  const frontendPackage = JSON.parse(await readFile(packageJsonPath, "utf8"))
-  frontendPackage.dependencies = {
-    ...frontendPackage.dependencies,
-    "@reset-framework/sdk": options.sdkDependencySpec
-  }
-
-  if (options.styling === "tailwindcss") {
-    frontendPackage.devDependencies = {
-      ...frontendPackage.devDependencies,
-      "@tailwindcss/vite": "latest",
-      tailwindcss: "latest"
-    }
-
-    await writeFile(packageJsonPath, JSON.stringify(frontendPackage, null, 2) + "\n", "utf8")
-    await writeFile(path.join(frontendDir, "vite.config.ts"), tailwindViteConfig, "utf8")
-    await writeFile(path.join(frontendDir, "src", "index.css"), tailwindIndexCss, "utf8")
-    await writeFile(path.join(frontendDir, "src", "App.tsx"), tailwindAppTsx, "utf8")
-    return
-  }
-
-  await writeFile(packageJsonPath, JSON.stringify(frontendPackage, null, 2) + "\n", "utf8")
-  await writeFile(path.join(frontendDir, "vite.config.ts"), standaloneViteConfig, "utf8")
-}
-
-function createRootPackageJson(options) {
-  const packageManagerVersion = options.packageManagerVersion
-    ? `${options.packageManager}@${options.packageManagerVersion}`
-    : undefined
-
-  const base = {
-    name: options.appName,
-    private: true,
-    version: "0.1.0",
-    description: `${options.productName} desktop app`,
-    scripts: {
-      dev: "reset-framework-cli dev",
-      build: "reset-framework-cli build",
-      package: "reset-framework-cli package",
-      doctor: "reset-framework-cli doctor"
-    },
-    devDependencies: {
-      "reset-framework-cli": options.cliDependencySpec
-    }
-  }
-
-  if (packageManagerVersion) {
-    base.packageManager = packageManagerVersion
-  }
-
-  if (options.frontendDir !== ".") {
-    base.workspaces = [options.frontendDir]
-    base.scripts["dev:web"] = "node ./scripts/run-frontend.mjs dev"
-    base.scripts["build:web"] = "node ./scripts/run-frontend.mjs build"
-    base.scripts["lint:web"] = "node ./scripts/run-frontend.mjs lint"
-    base.scripts["preview:web"] = "node ./scripts/run-frontend.mjs preview"
-  }
-
-  return base
-}
-
-function createRootReadme(options) {
-  const run = `${options.packageManager} run`
-  const webPath = options.frontendDir === "." ? "project root" : `${options.frontendDir}/`
-
-  return `# ${options.productName}
-
-Generated with \`reset-framework-cli\`.
-
-## Commands
-
-- \`${run} dev\`: start the frontend dev server and native desktop runtime
-- \`${run} build\`: build the frontend and stage the desktop app bundle
-- \`${run} package\`: archive the built desktop app
-- \`${run} doctor\`: inspect the project and framework installation
-
-## Web-only commands
-
-${options.frontendDir === "." ? `- \`${run} dev:web\`: run the Vite frontend only
-- \`${run} build:web\`: build the frontend only` : `- \`${run} dev:web\`: run the frontend workspace only
-- \`${run} build:web\`: build the frontend workspace only`}
-
-## Project files
-
-- \`reset.config.json\`: desktop app metadata and runtime configuration
-- \`${webPath}\`: web frontend source
-- \`.reset/\`: generated build output and native runtime cache
-`
-}
-
-async function writeRootPackageFiles(options) {
-  await writeFile(
-    path.join(options.targetDir, "README.md"),
-    createRootReadme(options),
-    "utf8"
-  )
-
-  if (options.frontendDir !== ".") {
-    await writeFile(
-      path.join(options.targetDir, "package.json"),
-      JSON.stringify(createRootPackageJson(options), null, 2) + "\n",
-      "utf8"
-    )
-
-    const scriptsDir = path.join(options.targetDir, "scripts")
-    await mkdir(scriptsDir, { recursive: true })
-    await writeFile(path.join(scriptsDir, "run-frontend.mjs"), rootFrontendRunner, "utf8")
-  }
-}
-
-async function writeProjectFiles(options) {
-  const templateConfig = JSON.parse(await readFile(options.templateConfigPath, "utf8"))
-
-  await writeFile(
-    path.join(options.targetDir, "reset.config.json"),
-    JSON.stringify(
-      {
-        ...templateConfig,
-        name: options.appName,
-        productName: options.productName,
-        appId: options.appId,
-        project: {
-          frontendDir: options.frontendDir,
-          styling: options.styling
-        },
-        window: {
-          ...templateConfig.window,
-          title: options.productName
-        }
-      },
-      null,
-      2
-    ) + "\n",
-    "utf8"
-  )
-
-  await writeFile(
-    path.join(options.targetDir, ".gitignore"),
-    getRootGitignore(options.frontendDir),
-    "utf8"
-  )
-}
-
-async function resolvePackageManagerVersion(packageManager) {
-  if (packageManager !== "npm" && packageManager !== "pnpm" && packageManager !== "yarn" && packageManager !== "bun") {
-    return null
-  }
-
-  try {
-    const command = resolvePackageManagerCommand(packageManager)
-    const result = await captureCommandOutput(command, ["--version"])
-    return typeof result === "string" && result.trim() !== "" ? result.trim() : null
-  } catch {
-    return null
-  }
-}
-
-async function collectCreateAppOptions(context, templates) {
-  const initialTarget = context.args[0] ?? "my-app"
-  const defaultTargetDir = path.resolve(context.cwd, initialTarget)
-  const defaultMetadata = makeAppMetadata(path.basename(defaultTargetDir))
-  const frameworkPaths = resolveFrameworkPaths()
-
-  const defaults = {
-    targetDir: defaultTargetDir,
-    templateName: typeof context.flags.template === "string" ? context.flags.template : "basic",
-    appName: defaultMetadata.name,
-    productName:
-      typeof context.flags["product-name"] === "string"
-        ? context.flags["product-name"]
-        : defaultMetadata.productName,
-    appId:
-      typeof context.flags["app-id"] === "string"
-        ? context.flags["app-id"]
-        : defaultMetadata.appId,
-    frontendDir: resolveDefaultFrontendDir(context),
-    styling: resolveDefaultStyling(context)
-  }
-
-  const interactive = isInteractiveSession() && !context.flags.yes && !context.flags["no-prompt"]
-
-  if (!interactive) {
-    if (!context.args[0]) {
-      throw new Error("Missing target directory. Use: reset-framework-cli create-app <directory>")
-    }
-
-    return {
-      ...defaults,
-      templateDir: path.join(frameworkPaths.templatesDir, defaults.templateName),
-      templateConfigPath: path.join(frameworkPaths.templatesDir, defaults.templateName, "reset.config.json"),
-      sourceFrontendDir: path.join(frameworkPaths.templatesDir, defaults.templateName, "frontend"),
-      cliDependencySpec: resolveCliDependencySpec(frameworkPaths),
-      sdkDependencySpec: resolveSdkDependencySpec(frameworkPaths),
-      packageManager: resolvePackageManagerOption(context),
-      packageManagerVersion: await resolvePackageManagerVersion(resolvePackageManagerOption(context)),
-      installDependencies: !context.flags["no-install"],
-      force: Boolean(context.flags.force)
-    }
-  }
-
-  const selected = await withPromptSession(async (rl) => {
-    const targetInput = await promptText(rl, {
-      label: "Project directory",
-      defaultValue: path.basename(defaults.targetDir),
-      validate(value) {
-        return value.trim() !== "" || "Enter a directory name."
-      }
-    })
-
-    const targetDir = path.resolve(context.cwd, targetInput)
-    const metadata = makeAppMetadata(path.basename(targetDir))
-
-    const templateName =
-      templates.length === 1
-        ? templates[0]
-        : await promptSelect(rl, {
-            label: "Template",
-            defaultValue: defaults.templateName,
-            choices: templates.map((template) => ({
-              value: template,
-              label: template,
-              description: "Starter project scaffold"
-            }))
-          })
-
-    const productName = await promptText(rl, {
-      label: "Product name",
-      defaultValue: defaults.productName || metadata.productName,
-      validate(value) {
-        return value.trim() !== "" || "Enter a product name."
-      }
-    })
-
-    const appId = await promptText(rl, {
-      label: "App ID",
-      defaultValue: defaults.appId || metadata.appId,
-      validate(value) {
-        return value.includes(".") || "Use a reverse-domain identifier such as com.example.my-app."
-      }
-    })
-
-    const frontendDir = await promptSelect(rl, {
-      label: "Frontend layout",
-      defaultValue: defaults.frontendDir === "." ? "." : "frontend",
-      choices: [
-        {
-          value: "frontend",
-          label: "Use a frontend/ subdirectory",
-          description: "Keeps the web app separate from config, output, and packaging files."
-        },
-        {
-          value: ".",
-          label: "Keep the frontend at project root",
-          description: "Flatter project layout with package.json and src/ directly in the app root."
-        }
-      ]
-    })
-
-    const styling = await promptSelect(rl, {
-      label: "Styling setup",
-      defaultValue: defaults.styling,
-      choices: [
-        {
-          value: "css",
-          label: "Vanilla CSS starter",
-          description: "Use the existing CSS-based starter with no extra styling dependency."
-        },
-        {
-          value: "tailwindcss",
-          label: "Tailwind CSS starter",
-          description: "Configure Tailwind CSS and swap the starter screen to utility classes."
-        }
-      ]
-    })
-
-    const installDependencies = await promptConfirm(rl, {
-      label: "Install frontend dependencies after scaffolding",
-      defaultValue: true
-    })
-
-    const packageManager = await promptSelect(rl, {
-      label: "Package manager",
-      defaultValue: resolvePackageManagerOption(context),
-      choices: [
-        {
-          value: "npm",
-          label: "npm",
-          description: "Wide compatibility and predictable installs."
-        },
-        {
-          value: "bun",
-          label: "bun",
-          description: "Fast installs and lets bun run the root desktop scripts."
-        },
-        {
-          value: "pnpm",
-          label: "pnpm",
-          description: "Strict dependency graph with workspace support."
-        },
-        {
-          value: "yarn",
-          label: "yarn",
-          description: "Classic workspace-based JavaScript package workflow."
-        }
-      ]
-    })
-
-    printSection("Summary")
-    printKeyValueTable([
-      ["Directory", targetDir],
-      ["Template", templateName],
-      ["Product", productName],
-      ["App ID", appId],
-      ["Frontend", frontendDir === "." ? "project root" : `${frontendDir}/`],
-      ["Styling", styling],
-      ["Package manager", packageManager],
-      ["Install", installDependencies ? "yes" : "no"]
-    ])
-    console.log("")
-
-    const confirmed = await promptConfirm(rl, {
-      label: "Create this project",
-      defaultValue: true
-    })
-
-    if (!confirmed) {
-      throw new Error("Create app cancelled.")
-    }
-
-    return {
-      targetDir,
-      templateName,
-      appName: metadata.name,
-      productName,
-      appId,
-      frontendDir,
-      styling,
-      installDependencies,
-      packageManager
-    }
-  })
-
-  return {
-    ...selected,
-    templateDir: path.join(frameworkPaths.templatesDir, selected.templateName),
-    templateConfigPath: path.join(frameworkPaths.templatesDir, selected.templateName, "reset.config.json"),
-    sourceFrontendDir: path.join(frameworkPaths.templatesDir, selected.templateName, "frontend"),
-    cliDependencySpec: resolveCliDependencySpec(frameworkPaths),
-    sdkDependencySpec: resolveSdkDependencySpec(frameworkPaths),
-    packageManagerVersion: await resolvePackageManagerVersion(selected.packageManager),
-    force: Boolean(context.flags.force)
-  }
-}
-
-export async function run(context) {
-  const frameworkPaths = resolveFrameworkPaths()
-  const templates = listTemplates(frameworkPaths.templatesDir)
-  const formatTargetForShell = (targetDir) => {
-    const relative = path.relative(context.cwd, targetDir)
-    if (relative === "" || (!relative.startsWith("..") && !path.isAbsolute(relative))) {
-      return relative || "."
-    }
-
-    return targetDir
-  }
-
-  printBanner("reset-framework-cli create-app", description)
-  const options = await collectCreateAppOptions(context, templates)
-
-  if (!templates.includes(options.templateName)) {
-    throw new Error(`Unknown template: ${options.templateName}`)
-  }
-
-  const targetFrontendDir =
-    options.frontendDir === "."
-      ? options.targetDir
-      : path.join(options.targetDir, options.frontendDir)
-
-  await ensureWritableTarget(options.targetDir, options.force)
-
-  printSection("Project")
-  printKeyValueTable([
-    ["Directory", options.targetDir],
-    ["Template", options.templateName],
-    ["Product", options.productName],
-    ["App ID", options.appId],
-    ["Frontend", options.frontendDir === "." ? "project root" : `${options.frontendDir}/`],
-    ["Styling", options.styling],
-    ["Package manager", options.packageManager],
-    ["Install", options.installDependencies ? describeInstallCommand(options.packageManager) : "skipped"]
-  ])
-
-  if (Boolean(context.flags["dry-run"])) {
-    console.log("")
-    printSection("Dry run")
-    printStatusTable([
-      ["plan", "Copy starter", `${options.sourceFrontendDir} -> ${targetFrontendDir}`],
-      ["plan", "Write README", path.join(options.targetDir, "README.md")],
-      ["plan", "Write config", path.join(options.targetDir, "reset.config.json")],
-      ["plan", "Write ignore file", path.join(options.targetDir, ".gitignore")],
-      ["plan", "Write app package", path.join(options.targetDir, "package.json")],
-      ["plan", "Write SDK bridge", path.join(targetFrontendDir, "src", "lib", "reset.ts")],
-      ["plan", "Write Vite config", path.join(targetFrontendDir, "vite.config.ts")],
-      ["plan", "Write TS config", path.join(targetFrontendDir, "tsconfig.app.json")]
-    ])
-    if (options.frontendDir !== ".") {
-      printStatusTable([
-        ["plan", "Write frontend runner", path.join(options.targetDir, "scripts", "run-frontend.mjs")]
-      ])
-    }
-    if (options.styling === "tailwindcss") {
-      printStatusTable([
-        ["plan", "Patch package.json", path.join(targetFrontendDir, "package.json")],
-        ["plan", "Write styles", path.join(targetFrontendDir, "src", "index.css")],
-        ["plan", "Write starter screen", path.join(targetFrontendDir, "src", "App.tsx")]
-      ])
-    }
-    if (options.installDependencies) {
-      printStatusTable([
-        ["plan", "Install dependencies", `${describeInstallCommand(options.packageManager)} in ${options.targetDir}`]
-      ])
-    }
-    return
-  }
-
-  console.log("")
-  const progress = createProgress(options.installDependencies ? 6 : 5, "Scaffold")
-
-  await mkdir(options.targetDir, { recursive: true })
-  progress.tick("Prepared project directory")
-
-  await copyFrontendTemplate(options.sourceFrontendDir, targetFrontendDir, options)
-  progress.tick("Copied frontend starter")
-
-  await writeProjectFiles(options)
-  await writeRootPackageFiles(options)
-  progress.tick("Wrote project files")
-
-  await applyFrontendOverrides(targetFrontendDir, options)
-  progress.tick("Applied frontend package wiring")
-
-  const packageJsonPath = path.join(targetFrontendDir, "package.json")
-  const frontendPackage = JSON.parse(await readFile(packageJsonPath, "utf8"))
-
-  if (options.frontendDir === ".") {
-    const currentScripts = { ...(frontendPackage.scripts ?? {}) }
-    frontendPackage.name = options.appName
-    frontendPackage.private = true
-    frontendPackage.version = "0.1.0"
-    frontendPackage.description = `${options.productName} desktop app`
-    frontendPackage.devDependencies = {
-      ...frontendPackage.devDependencies,
-      "reset-framework-cli": options.cliDependencySpec
-    }
-    frontendPackage.scripts = {
-      dev: "reset-framework-cli dev",
-      "dev:web": currentScripts.dev ?? "vite",
-      build: "reset-framework-cli build",
-      "build:web": currentScripts.build ?? "tsc -b && vite build",
-      package: "reset-framework-cli package",
-      doctor: "reset-framework-cli doctor",
-      lint: currentScripts.lint ?? "eslint .",
-      preview: currentScripts.preview ?? "vite preview"
-    }
-
-    if (options.packageManagerVersion) {
-      frontendPackage.packageManager = `${options.packageManager}@${options.packageManagerVersion}`
-    }
-  } else {
-    frontendPackage.name = `${options.appName}-frontend`
-  }
-
-  await writeFile(packageJsonPath, JSON.stringify(frontendPackage, null, 2) + "\n", "utf8")
-  progress.tick("Finalized starter metadata")
-
-  if (options.installDependencies) {
-    await runCommand(
-      resolvePackageManagerCommand(options.packageManager),
-      getInstallCommandArgs(options.packageManager),
-      {
-        cwd: options.targetDir
-      }
-    )
-    progress.tick("Installed frontend dependencies")
-  }
-
-  console.log("")
-  printSection("Result")
-  printStatusTable([
-    ["done", "Project", options.targetDir],
-    ["done", "Next step", `cd ${formatTargetForShell(options.targetDir)} && ${options.packageManager} run dev`]
-  ])
-}
+
+child.once('error', (error) => {
+  console.error(error)
+  process.exit(1)
+})
+
+child.once('exit', (code, signal) => {
+  if (signal) {
+    process.kill(process.pid, signal)
+    return
+  }
+
+  process.exit(code ?? 1)
+})
+`
+
+export const description = "Scaffold a starter app with an interactive project setup"
+
+function listTemplates(templatesDir) {
+  return readdirSync(templatesDir, { withFileTypes: true })
+    .filter((entry) => entry.isDirectory())
+    .map((entry) => entry.name)
+    .sort()
+}
+
+function getRootGitignore(frontendDir) {
+  if (frontendDir === ".") {
+    return `.DS_Store
+Thumbs.db
+.idea/
+.vs/
+.vscode/
+.cache/
+.reset/
+.turbo/
+build/
+coverage/
+dist/
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+*.log
+*.zip
+*.tgz
+*.tsbuildinfo
+*.dSYM/
+.env
+.env.*
+.env.local
+.env.*.local
+.eslintcache
+bun.lock
+bun.lockb
+compile_commands.json
+CMakeUserPresets.json
+CMakeCache.txt
+CMakeFiles/
+cmake_install.cmake
+install_manifest.txt
+cmake-build-*/
+Testing/
+scripts/local/
+`
+  }
+
+  return `.DS_Store
+Thumbs.db
+.idea/
+.vs/
+.vscode/
+.cache/
+.reset/
+.turbo/
+build/
+coverage/
+node_modules/
+${frontendDir}/node_modules/
+${frontendDir}/dist/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+*.log
+*.zip
+*.tgz
+*.tsbuildinfo
+*.dSYM/
+.env
+.env.*
+.env.local
+.env.*.local
+.eslintcache
+bun.lock
+bun.lockb
+compile_commands.json
+CMakeUserPresets.json
+CMakeCache.txt
+CMakeFiles/
+cmake_install.cmake
+install_manifest.txt
+cmake-build-*/
+Testing/
+scripts/local/
+`
+}
+
+function resolveDefaultFrontendDir(context) {
+  if (typeof context.flags["frontend-dir"] === "string") {
+    return context.flags["frontend-dir"]
+  }
+
+  if (context.flags.flat) {
+    return "."
+  }
+
+  return "frontend"
+}
+
+function resolveDefaultStyling(context) {
+  if (context.flags.tailwind) {
+    return "tailwindcss"
+  }
+
+  if (context.flags["no-tailwind"]) {
+    return "css"
+  }
+
+  return "css"
+}
+
+function resolvePackageManagerOption(context) {
+  if (typeof context.flags["package-manager"] === "string") {
+    return context.flags["package-manager"]
+  }
+
+  return "npm"
+}
+
+function describeInstallCommand(packageManager) {
+  return [packageManager, ...getInstallCommandArgs(packageManager)].join(" ")
+}
+
+async function ensureWritableTarget(targetDir, force) {
+  if (!existsSync(targetDir)) {
+    return
+  }
+
+  const entries = await readdir(targetDir)
+
+  if (entries.length > 0 && !force) {
+    throw new Error(`Target directory is not empty: ${targetDir}. Use --force to continue.`)
+  }
+}
+
+async function copyFrontendTemplate(sourceFrontendDir, targetFrontendDir, options) {
+  const { force, frontendDir } = options
+  const flatLayout = frontendDir === "."
+
+  if (!flatLayout) {
+    await cp(sourceFrontendDir, targetFrontendDir, {
+      recursive: true,
+      force,
+      filter(source) {
+        const baseName = path.basename(source)
+        return (
+          baseName !== "node_modules" &&
+          baseName !== "dist" &&
+          baseName !== "bun.lockb" &&
+          baseName !== "reset.config.json"
+        )
+      }
+    })
+
+    return
+  }
+
+  await mkdir(targetFrontendDir, { recursive: true })
+
+  const entries = await readdir(sourceFrontendDir, { withFileTypes: true })
+  for (const entry of entries) {
+    if (["node_modules", "dist", "bun.lockb", "reset.config.json", ".gitignore", "README.md"].includes(entry.name)) {
+      continue
+    }
+
+    await cp(
+      path.join(sourceFrontendDir, entry.name),
+      path.join(targetFrontendDir, entry.name),
+      { recursive: true, force }
+    )
+  }
+}
+
+async function applyFrontendOverrides(frontendDir, options) {
+  await writeFile(path.join(frontendDir, "src", "lib", "reset.ts"), sdkRuntimeReexport, "utf8")
+  await writeFile(path.join(frontendDir, "tsconfig.app.json"), standaloneTsconfigApp, "utf8")
+
+  const packageJsonPath = path.join(frontendDir, "package.json")
+  const frontendPackage = JSON.parse(await readFile(packageJsonPath, "utf8"))
+  frontendPackage.dependencies = {
+    ...frontendPackage.dependencies,
+    "@reset-framework/sdk": options.sdkDependencySpec
+  }
+
+  if (options.styling === "tailwindcss") {
+    frontendPackage.devDependencies = {
+      ...frontendPackage.devDependencies,
+      "@tailwindcss/vite": "latest",
+      tailwindcss: "latest"
+    }
+
+    await writeFile(packageJsonPath, JSON.stringify(frontendPackage, null, 2) + "\n", "utf8")
+    await writeFile(path.join(frontendDir, "vite.config.ts"), tailwindViteConfig, "utf8")
+    await writeFile(path.join(frontendDir, "src", "index.css"), tailwindIndexCss, "utf8")
+    await writeFile(path.join(frontendDir, "src", "App.tsx"), tailwindAppTsx, "utf8")
+    return
+  }
+
+  await writeFile(packageJsonPath, JSON.stringify(frontendPackage, null, 2) + "\n", "utf8")
+  await writeFile(path.join(frontendDir, "vite.config.ts"), standaloneViteConfig, "utf8")
+}
+
+function createRootPackageJson(options) {
+  const packageManagerVersion = options.packageManagerVersion
+    ? `${options.packageManager}@${options.packageManagerVersion}`
+    : undefined
+
+  const base = {
+    name: options.appName,
+    private: true,
+    version: "0.1.0",
+    description: `${options.productName} desktop app`,
+    scripts: {
+      dev: "reset-framework-cli dev",
+      build: "reset-framework-cli build",
+      package: "reset-framework-cli package",
+      doctor: "reset-framework-cli doctor"
+    },
+    devDependencies: {
+      "reset-framework-cli": options.cliDependencySpec
+    }
+  }
+
+  if (packageManagerVersion) {
+    base.packageManager = packageManagerVersion
+  }
+
+  if (options.frontendDir !== ".") {
+    base.workspaces = [options.frontendDir]
+    base.scripts["dev:web"] = "node ./scripts/run-frontend.mjs dev"
+    base.scripts["build:web"] = "node ./scripts/run-frontend.mjs build"
+    base.scripts["lint:web"] = "node ./scripts/run-frontend.mjs lint"
+    base.scripts["preview:web"] = "node ./scripts/run-frontend.mjs preview"
+  }
+
+  return base
+}
+
+function createRootReadme(options) {
+  const run = `${options.packageManager} run`
+  const webPath = options.frontendDir === "." ? "project root" : `${options.frontendDir}/`
+
+  return `# ${options.productName}
+
+Generated with \`reset-framework-cli\`.
+
+## Commands
+
+- \`${run} dev\`: start the frontend dev server and native desktop runtime
+- \`${run} build\`: build the frontend and stage the desktop app bundle
+- \`${run} package\`: archive the built desktop app
+- \`${run} doctor\`: inspect the project and framework installation
+
+## Web-only commands
+
+${options.frontendDir === "." ? `- \`${run} dev:web\`: run the Vite frontend only
+- \`${run} build:web\`: build the frontend only` : `- \`${run} dev:web\`: run the frontend workspace only
+- \`${run} build:web\`: build the frontend workspace only`}
+
+## Project files
+
+- \`reset.config.json\`: desktop app metadata and runtime configuration
+- \`${webPath}\`: web frontend source
+- \`.reset/\`: generated build output and native runtime cache
+`
+}
+
+async function writeRootPackageFiles(options) {
+  await writeFile(
+    path.join(options.targetDir, "README.md"),
+    createRootReadme(options),
+    "utf8"
+  )
+
+  if (options.frontendDir !== ".") {
+    await writeFile(
+      path.join(options.targetDir, "package.json"),
+      JSON.stringify(createRootPackageJson(options), null, 2) + "\n",
+      "utf8"
+    )
+
+    const scriptsDir = path.join(options.targetDir, "scripts")
+    await mkdir(scriptsDir, { recursive: true })
+    await writeFile(path.join(scriptsDir, "run-frontend.mjs"), rootFrontendRunner, "utf8")
+  }
+}
+
+async function writeProjectFiles(options) {
+  const templateConfig = JSON.parse(await readFile(options.templateConfigPath, "utf8"))
+
+  await writeFile(
+    path.join(options.targetDir, "reset.config.json"),
+    JSON.stringify(
+      {
+        ...templateConfig,
+        name: options.appName,
+        productName: options.productName,
+        appId: options.appId,
+        project: {
+          frontendDir: options.frontendDir,
+          styling: options.styling
+        },
+        window: {
+          ...templateConfig.window,
+          title: options.productName
+        }
+      },
+      null,
+      2
+    ) + "\n",
+    "utf8"
+  )
+
+  await writeFile(
+    path.join(options.targetDir, ".gitignore"),
+    getRootGitignore(options.frontendDir),
+    "utf8"
+  )
+}
+
+async function resolvePackageManagerVersion(packageManager) {
+  if (packageManager !== "npm" && packageManager !== "pnpm" && packageManager !== "yarn" && packageManager !== "bun") {
+    return null
+  }
+
+  try {
+    const command = resolvePackageManagerCommand(packageManager)
+    const result = await captureCommandOutput(command, ["--version"])
+    return typeof result === "string" && result.trim() !== "" ? result.trim() : null
+  } catch {
+    return null
+  }
+}
+
+async function collectCreateAppOptions(context, templates) {
+  const initialTarget = context.args[0] ?? "my-app"
+  const defaultTargetDir = path.resolve(context.cwd, initialTarget)
+  const defaultMetadata = makeAppMetadata(path.basename(defaultTargetDir))
+  const frameworkPaths = resolveFrameworkPaths()
+
+  const defaults = {
+    targetDir: defaultTargetDir,
+    templateName: typeof context.flags.template === "string" ? context.flags.template : "basic",
+    appName: defaultMetadata.name,
+    productName:
+      typeof context.flags["product-name"] === "string"
+        ? context.flags["product-name"]
+        : defaultMetadata.productName,
+    appId:
+      typeof context.flags["app-id"] === "string"
+        ? context.flags["app-id"]
+        : defaultMetadata.appId,
+    frontendDir: resolveDefaultFrontendDir(context),
+    styling: resolveDefaultStyling(context)
+  }
+
+  const interactive = isInteractiveSession() && !context.flags.yes && !context.flags["no-prompt"]
+
+  if (!interactive) {
+    if (!context.args[0]) {
+      throw new Error("Missing target directory. Use: reset-framework-cli create-app <directory>")
+    }
+
+    return {
+      ...defaults,
+      templateDir: path.join(frameworkPaths.templatesDir, defaults.templateName),
+      templateConfigPath: path.join(frameworkPaths.templatesDir, defaults.templateName, "reset.config.json"),
+      sourceFrontendDir: path.join(frameworkPaths.templatesDir, defaults.templateName, "frontend"),
+      cliDependencySpec: resolveCliDependencySpec(frameworkPaths),
+      sdkDependencySpec: resolveSdkDependencySpec(frameworkPaths),
+      packageManager: resolvePackageManagerOption(context),
+      packageManagerVersion: await resolvePackageManagerVersion(resolvePackageManagerOption(context)),
+      installDependencies: !context.flags["no-install"],
+      force: Boolean(context.flags.force)
+    }
+  }
+
+  const selected = await withPromptSession(async (rl) => {
+    const targetInput = await promptText(rl, {
+      label: "Project directory",
+      defaultValue: path.basename(defaults.targetDir),
+      validate(value) {
+        return value.trim() !== "" || "Enter a directory name."
+      }
+    })
+
+    const targetDir = path.resolve(context.cwd, targetInput)
+    const metadata = makeAppMetadata(path.basename(targetDir))
+
+    const templateName =
+      templates.length === 1
+        ? templates[0]
+        : await promptSelect(rl, {
+            label: "Template",
+            defaultValue: defaults.templateName,
+            choices: templates.map((template) => ({
+              value: template,
+              label: template,
+              description: "Starter project scaffold"
+            }))
+          })
+
+    const productName = await promptText(rl, {
+      label: "Product name",
+      defaultValue: defaults.productName || metadata.productName,
+      validate(value) {
+        return value.trim() !== "" || "Enter a product name."
+      }
+    })
+
+    const appId = await promptText(rl, {
+      label: "App ID",
+      defaultValue: defaults.appId || metadata.appId,
+      validate(value) {
+        return value.includes(".") || "Use a reverse-domain identifier such as com.example.my-app."
+      }
+    })
+
+    const frontendDir = await promptSelect(rl, {
+      label: "Frontend layout",
+      defaultValue: defaults.frontendDir === "." ? "." : "frontend",
+      choices: [
+        {
+          value: "frontend",
+          label: "Use a frontend/ subdirectory",
+          description: "Keeps the web app separate from config, output, and packaging files."
+        },
+        {
+          value: ".",
+          label: "Keep the frontend at project root",
+          description: "Flatter project layout with package.json and src/ directly in the app root."
+        }
+      ]
+    })
+
+    const styling = await promptSelect(rl, {
+      label: "Styling setup",
+      defaultValue: defaults.styling,
+      choices: [
+        {
+          value: "css",
+          label: "Vanilla CSS starter",
+          description: "Use the existing CSS-based starter with no extra styling dependency."
+        },
+        {
+          value: "tailwindcss",
+          label: "Tailwind CSS starter",
+          description: "Configure Tailwind CSS and swap the starter screen to utility classes."
+        }
+      ]
+    })
+
+    const installDependencies = await promptConfirm(rl, {
+      label: "Install frontend dependencies after scaffolding",
+      defaultValue: true
+    })
+
+    const packageManager = await promptSelect(rl, {
+      label: "Package manager",
+      defaultValue: resolvePackageManagerOption(context),
+      choices: [
+        {
+          value: "npm",
+          label: "npm",
+          description: "Wide compatibility and predictable installs."
+        },
+        {
+          value: "bun",
+          label: "bun",
+          description: "Fast installs and lets bun run the root desktop scripts."
+        },
+        {
+          value: "pnpm",
+          label: "pnpm",
+          description: "Strict dependency graph with workspace support."
+        },
+        {
+          value: "yarn",
+          label: "yarn",
+          description: "Classic workspace-based JavaScript package workflow."
+        }
+      ]
+    })
+
+    printSection("Summary")
+    printKeyValueTable([
+      ["Directory", targetDir],
+      ["Template", templateName],
+      ["Product", productName],
+      ["App ID", appId],
+      ["Frontend", frontendDir === "." ? "project root" : `${frontendDir}/`],
+      ["Styling", styling],
+      ["Package manager", packageManager],
+      ["Install", installDependencies ? "yes" : "no"]
+    ])
+    console.log("")
+
+    const confirmed = await promptConfirm(rl, {
+      label: "Create this project",
+      defaultValue: true
+    })
+
+    if (!confirmed) {
+      throw new Error("Create app cancelled.")
+    }
+
+    return {
+      targetDir,
+      templateName,
+      appName: metadata.name,
+      productName,
+      appId,
+      frontendDir,
+      styling,
+      installDependencies,
+      packageManager
+    }
+  })
+
+  return {
+    ...selected,
+    templateDir: path.join(frameworkPaths.templatesDir, selected.templateName),
+    templateConfigPath: path.join(frameworkPaths.templatesDir, selected.templateName, "reset.config.json"),
+    sourceFrontendDir: path.join(frameworkPaths.templatesDir, selected.templateName, "frontend"),
+    cliDependencySpec: resolveCliDependencySpec(frameworkPaths),
+    sdkDependencySpec: resolveSdkDependencySpec(frameworkPaths),
+    packageManagerVersion: await resolvePackageManagerVersion(selected.packageManager),
+    force: Boolean(context.flags.force)
+  }
+}
+
+export async function run(context) {
+  const frameworkPaths = resolveFrameworkPaths()
+  const templates = listTemplates(frameworkPaths.templatesDir)
+  const formatTargetForShell = (targetDir) => {
+    const relative = path.relative(context.cwd, targetDir)
+    if (relative === "" || (!relative.startsWith("..") && !path.isAbsolute(relative))) {
+      return relative || "."
+    }
+
+    return targetDir
+  }
+
+  printBanner("reset-framework-cli create-app", description)
+  const options = await collectCreateAppOptions(context, templates)
+
+  if (!templates.includes(options.templateName)) {
+    throw new Error(`Unknown template: ${options.templateName}`)
+  }
+
+  const targetFrontendDir =
+    options.frontendDir === "."
+      ? options.targetDir
+      : path.join(options.targetDir, options.frontendDir)
+
+  await ensureWritableTarget(options.targetDir, options.force)
+
+  printSection("Project")
+  printKeyValueTable([
+    ["Directory", options.targetDir],
+    ["Template", options.templateName],
+    ["Product", options.productName],
+    ["App ID", options.appId],
+    ["Frontend", options.frontendDir === "." ? "project root" : `${options.frontendDir}/`],
+    ["Styling", options.styling],
+    ["Package manager", options.packageManager],
+    ["Install", options.installDependencies ? describeInstallCommand(options.packageManager) : "skipped"]
+  ])
+
+  if (Boolean(context.flags["dry-run"])) {
+    console.log("")
+    printSection("Dry run")
+    printStatusTable([
+      ["plan", "Copy starter", `${options.sourceFrontendDir} -> ${targetFrontendDir}`],
+      ["plan", "Write README", path.join(options.targetDir, "README.md")],
+      ["plan", "Write config", path.join(options.targetDir, "reset.config.json")],
+      ["plan", "Write ignore file", path.join(options.targetDir, ".gitignore")],
+      ["plan", "Write app package", path.join(options.targetDir, "package.json")],
+      ["plan", "Write SDK bridge", path.join(targetFrontendDir, "src", "lib", "reset.ts")],
+      ["plan", "Write Vite config", path.join(targetFrontendDir, "vite.config.ts")],
+      ["plan", "Write TS config", path.join(targetFrontendDir, "tsconfig.app.json")]
+    ])
+    if (options.frontendDir !== ".") {
+      printStatusTable([
+        ["plan", "Write frontend runner", path.join(options.targetDir, "scripts", "run-frontend.mjs")]
+      ])
+    }
+    if (options.styling === "tailwindcss") {
+      printStatusTable([
+        ["plan", "Patch package.json", path.join(targetFrontendDir, "package.json")],
+        ["plan", "Write styles", path.join(targetFrontendDir, "src", "index.css")],
+        ["plan", "Write starter screen", path.join(targetFrontendDir, "src", "App.tsx")]
+      ])
+    }
+    if (options.installDependencies) {
+      printStatusTable([
+        ["plan", "Install dependencies", `${describeInstallCommand(options.packageManager)} in ${options.targetDir}`]
+      ])
+    }
+    return
+  }
+
+  console.log("")
+  const progress = createProgress(options.installDependencies ? 6 : 5, "Scaffold")
+
+  await mkdir(options.targetDir, { recursive: true })
+  progress.tick("Prepared project directory")
+
+  await copyFrontendTemplate(options.sourceFrontendDir, targetFrontendDir, options)
+  progress.tick("Copied frontend starter")
+
+  await writeProjectFiles(options)
+  await writeRootPackageFiles(options)
+  progress.tick("Wrote project files")
+
+  await applyFrontendOverrides(targetFrontendDir, options)
+  progress.tick("Applied frontend package wiring")
+
+  const packageJsonPath = path.join(targetFrontendDir, "package.json")
+  const frontendPackage = JSON.parse(await readFile(packageJsonPath, "utf8"))
+
+  if (options.frontendDir === ".") {
+    const currentScripts = { ...(frontendPackage.scripts ?? {}) }
+    frontendPackage.name = options.appName
+    frontendPackage.private = true
+    frontendPackage.version = "0.1.0"
+    frontendPackage.description = `${options.productName} desktop app`
+    frontendPackage.devDependencies = {
+      ...frontendPackage.devDependencies,
+      "reset-framework-cli": options.cliDependencySpec
+    }
+    frontendPackage.scripts = {
+      dev: "reset-framework-cli dev",
+      "dev:web": currentScripts.dev ?? "vite",
+      build: "reset-framework-cli build",
+      "build:web": currentScripts.build ?? "tsc -b && vite build",
+      package: "reset-framework-cli package",
+      doctor: "reset-framework-cli doctor",
+      lint: currentScripts.lint ?? "eslint .",
+      preview: currentScripts.preview ?? "vite preview"
+    }
+
+    if (options.packageManagerVersion) {
+      frontendPackage.packageManager = `${options.packageManager}@${options.packageManagerVersion}`
+    }
+  } else {
+    frontendPackage.name = `${options.appName}-frontend`
+  }
+
+  await writeFile(packageJsonPath, JSON.stringify(frontendPackage, null, 2) + "\n", "utf8")
+  progress.tick("Finalized starter metadata")
+
+  if (options.installDependencies) {
+    await runCommand(
+      resolvePackageManagerCommand(options.packageManager),
+      getInstallCommandArgs(options.packageManager),
+      {
+        cwd: options.targetDir
+      }
+    )
+    progress.tick("Installed frontend dependencies")
+  }
+
+  console.log("")
+  printSection("Result")
+  printStatusTable([
+    ["done", "Project", options.targetDir],
+    ["done", "Next step", `cd ${formatTargetForShell(options.targetDir)} && ${options.packageManager} run dev`]
+  ])
+}