create-expo-super-stack 0.1.8 → 0.1.10

package/dist/cli.js

@@ -1,17 +1,17 @@
 #!/usr/bin/env node
-import { spawn } from 'node:child_process';
-import { access, mkdir, readdir, readFile, rename, rm, writeFile } from 'node:fs/promises';
-import path from 'node:path';
-import { fileURLToPath, pathToFileURL } from 'node:url';
-import { cancel, isCancel, log, text } from '@clack/prompts';
-import { SUPER_STACK_SUCCESS_MESSAGE, collectOnboardPlan, defaultOnboardPlan, savePersonalOnboardDefaults, } from '@mr.dj2u/cli/onboarding';
-import { scaffoldProjectMemory } from '@mr.dj2u/cli/project-memory';
-const DEFAULT_PROJECT_NAME = 'my-expo-app';
-const CURRENT_EXPO_SDK_MAJOR = 56;
-const CURRENT_EXPO_SDK_VERSION = '~56.0.6';
+import { spawn } from "node:child_process";
+import { access, mkdir, readdir, readFile, rename, rm, writeFile, } from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import { cancel, isCancel, log, text } from "@clack/prompts";
+import { SUPER_STACK_SUCCESS_MESSAGE, collectOnboardPlan, defaultOnboardPlan, savePersonalOnboardDefaults, } from "@mr.dj2u/cli/onboarding";
+import { scaffoldProjectMemory } from "@mr.dj2u/cli/project-memory";
+import { generateProjectRoadmap, } from "@mr.dj2u/cli/roadmap";
+const DEFAULT_PROJECT_NAME = "my-expo-app";
+export const EXPECTED_EXPO_SDK_MAJOR = 56;
 const STYLIST_SYNC_API_ROUTES = [
-    'app/exposition/stylist-sync+api.ts',
-    'src/app/exposition/stylist-sync+api.ts',
+    "app/exposition/stylist-sync+api.ts",
+    "src/app/exposition/stylist-sync+api.ts",
 ];
 export async function main() {
     const initialParsed = parseArgs(process.argv.slice(2));
@@ -29,7 +29,7 @@ export async function main() {
         await runCreateExpoStack(createExpoStackArgs, parsed.mds.createExpoStackBin, projectParentDir);
     }
     else {
-        console.log('Skipping create-expo-stack because --mds-skip-create was passed.');
+        console.log("Skipping create-expo-stack because --mds-skip-create was passed.");
     }
     const projectPath = await resolveGeneratedProjectPath(projectParentDir, projectName);
     const easSelected = await detectEasSetup(projectPath, parsed.createExpoStackArgs);
@@ -37,13 +37,15 @@ export async function main() {
     const plan = parsed.mds.yes
         ? defaultOnboardPlan(onboardArgv, projectPath)
         : await collectOnboardPlan(onboardArgv, projectPath);
-    const movedAppDir = !parsed.mds.skipCreate && plan.answers.appDirectory === 'src'
+    const movedAppDir = !parsed.mds.skipCreate && plan.answers.appDirectory === "src"
         ? await moveRootAppIntoSrc(projectPath)
         : null;
-    const consolidatedSourceRepairs = !parsed.mds.skipCreate && plan.answers.appDirectory === 'src'
+    const consolidatedSourceRepairs = !parsed.mds.skipCreate && plan.answers.appDirectory === "src"
         ? await consolidateRootSourceFolders(projectPath)
         : [];
-    const movedImportRepairs = movedAppDir ? await repairMovedSrcAppImports(projectPath) : [];
+    const movedImportRepairs = movedAppDir
+        ? await repairMovedSrcAppImports(projectPath)
+        : [];
     const written = await scaffoldProjectMemory(projectPath, plan.answers, {
         force: parsed.mds.force,
         guidelinesTemplate: plan.guidelinesTemplate,
@@ -51,21 +53,24 @@ export async function main() {
         manageUniwind: parsed.mds.skipCreate,
         richBoilerplate: plan.richBoilerplate,
     });
-    const postScaffoldImportRepairs = movedAppDir ? await repairMovedSrcAppImports(projectPath) : [];
+    const postScaffoldImportRepairs = movedAppDir
+        ? await repairMovedSrcAppImports(projectPath)
+        : [];
     const identifierRepairs = await repairExpoProjectIdentifiers(projectPath, projectName, plan.answers.targetPlatforms);
-    const stylistWebOutputRepairs = plan.answers.targetPlatforms.includes('web')
+    const stylistWebOutputRepairs = plan.answers.targetPlatforms.includes("web")
         ? await repairExpoWebOutputForStylistLifecycle(projectPath, plan.answers.webOutput)
         : [];
     const hasStylistSyncRoute = await hasStylistSyncApiRoute(projectPath);
     const typeSupportRepairs = await repairGeneratedTypeSupport(projectPath, {
-        needsNodeTypes: plan.answers.targetPlatforms.includes('web') && hasStylistSyncRoute,
-        needsUniwindTypes: plan.answers.defaults.includes('uniwind'),
+        needsNodeTypes: hasStylistSyncRoute,
+        needsUniwindTypes: plan.answers.defaults.includes("uniwind"),
     });
     const nativeWindUiPickerRepairs = await repairGeneratedNativeWindUiPicker(projectPath);
+    const eslintConfigRepairs = await repairGeneratedEslintConfig(projectPath);
     console.log();
-    console.log('MDS onboarding complete.');
+    console.log("MDS onboarding complete.");
     for (const result of written) {
-        console.log(`${result.wrote ? 'CREATED' : 'KEPT'} ${path.relative(process.cwd(), result.filePath)}`);
+        console.log(`${result.wrote ? "CREATED" : "KEPT"} ${path.relative(process.cwd(), result.filePath)}`);
     }
     if (movedAppDir) {
         console.log(`MOVED ${path.relative(process.cwd(), movedAppDir.from)} -> ${path.relative(process.cwd(), movedAppDir.to)}`);
@@ -91,42 +96,61 @@ export async function main() {
     for (const result of nativeWindUiPickerRepairs) {
         console.log(`UPDATED ${path.relative(process.cwd(), result)}`);
     }
+    for (const result of eslintConfigRepairs) {
+        console.log(`UPDATED ${path.relative(process.cwd(), result)}`);
+    }
     if (plan.saveDefaults) {
         const defaultsPath = savePersonalOnboardDefaults(plan.answers);
         if (defaultsPath) {
             console.log(`Saved personal onboarding defaults: ${defaultsPath}`);
         }
     }
+    const roadmapStatus = await generateProjectRoadmap(projectPath, {
+        write: false,
+        preserveStatus: true,
+    });
+    if (roadmapStatus.blockedByMarkers) {
+        console.log();
+        console.log("Roadmap note:");
+        console.log("Unresolved # TodoForContext(optional): markers are still present in project/info.md, so MDS intentionally left the scaffolded phase template in place.");
+        console.log("Resolve those project/info.md markers first, then run `mds roadmap` or let your agent refresh project/todo.md from project/info.md.");
+    }
+    else if (roadmapStatus.needsClarification) {
+        console.log();
+        console.log("Roadmap note:");
+        console.log("The project docs are still too generic for a high-confidence derived roadmap, so have your agent ask clarifying questions and then rerun `mds roadmap`.");
+    }
     const packageManager = await detectPackageManager(projectPath, parsed.createExpoStackArgs);
     const noInstallRequested = hasNoInstallFlag(parsed.createExpoStackArgs);
     if (shouldRunExpoProjectChecks(parsed, noInstallRequested)) {
-        await runExpoProjectChecks(projectPath, packageManager, {
-            useLatestExpoSdk: plan.answers.useLatestExpoSdk,
-        });
+        await runExpoProjectChecks(projectPath, packageManager);
     }
     else if (noInstallRequested) {
         console.log();
-        console.log('Skipped install and Expo dependency repair because create-expo-stack was run with --no-install.');
+        console.log("Skipped install and Expo dependency repair because create-expo-stack was run with --no-install.");
     }
+    await assertExpectedExpoSdk(projectPath);
     console.log();
-    console.log('Next steps:');
-    console.log(`  cd ${quoteDisplayArg(path.relative(process.cwd(), projectPath) || '.')}`);
+    const nextStepsCommands = [
+        `cd ${quoteDisplayArg(path.relative(process.cwd(), projectPath) || ".")}`,
+    ];
     if (noInstallRequested || parsed.mds.skipExpoFix || parsed.mds.skipCreate) {
-        console.log(`  ${buildInstallCommand(packageManager).display}`);
-        if (plan.answers.useLatestExpoSdk && (await shouldRunExpoLatestSdkCommand(projectPath))) {
-            console.log(`  ${buildExpoLatestSdkCommand(packageManager).display}`);
+        nextStepsCommands.push(buildInstallCommand(packageManager).display);
+        if (await shouldRunExpoLatestSdkCommand(projectPath)) {
+            nextStepsCommands.push(buildExpoLatestSdkCommand(packageManager).display);
         }
-        console.log(`  ${buildExpoInstallFixCommand(packageManager).display}`);
+        nextStepsCommands.push(buildExpoInstallFixCommand(packageManager).display);
         if (await shouldInstallExpoFontPeer(projectPath)) {
-            console.log(`  ${buildExpoFontInstallCommand(packageManager).display}`);
+            nextStepsCommands.push(buildExpoFontInstallCommand(packageManager).display);
         }
-        console.log(`  ${buildExpoDoctorCommand(packageManager).display}`);
+        nextStepsCommands.push(buildExpoDoctorCommand(packageManager).display);
     }
-    console.log(`  ${buildRunScriptCommand(packageManager, 'clear-expo-start')}`);
+    nextStepsCommands.push(buildRunScriptCommand(packageManager, "clear-expo-start"));
+    printCopyableCommands("Next steps", nextStepsCommands);
     console.log();
     console.log(SUPER_STACK_SUCCESS_MESSAGE);
     console.log();
-    console.log('For the full dev-suite locally, use the generated scripts or install @mr.dj2u/cli in the app.');
+    console.log("For the full dev-suite locally, use the generated scripts or install @mr.dj2u/cli in the app.");
 }
 export function prepareCreateExpoStackArgsForWrapper(args, _skipExpoFix = false) {
     return args;
@@ -146,8 +170,8 @@ export function parseArgs(args) {
         if (!arg) {
             continue;
         }
-        if (!arg.startsWith('--') && !projectName) {
-            if (arg === '-h') {
+        if (!arg.startsWith("--") && !projectName) {
+            if (arg === "-h") {
                 helpRequested = true;
                 continue;
             }
@@ -155,192 +179,191 @@ export function parseArgs(args) {
             createExpoStackArgs.push(arg);
             continue;
         }
-        if (arg === '--help' || arg === '-h' || arg === '--mds-help') {
+        if (arg === "--help" || arg === "-h" || arg === "--mds-help") {
             helpRequested = true;
             continue;
         }
-        if (arg === '--mds-force') {
+        if (arg === "--mds-force") {
             mds.force = true;
             continue;
         }
-        if (arg === '--mds-no-rich') {
+        if (arg === "--mds-no-rich") {
             mds.rich = false;
             continue;
         }
-        if (arg === '--mds-rich') {
+        if (arg === "--mds-rich") {
             mds.rich = true;
             continue;
         }
-        if (arg === '--mds-save-defaults') {
+        if (arg === "--mds-save-defaults") {
             mds.saveDefaults = true;
             continue;
         }
-        if (arg === '--mds-no-save-defaults') {
+        if (arg === "--mds-no-save-defaults") {
             mds.saveDefaults = false;
             continue;
         }
-        if (arg === '--mds-yes' || arg === '--mds-non-interactive') {
+        if (arg === "--mds-yes" || arg === "--mds-non-interactive") {
             mds.yes = true;
             continue;
         }
-        if (arg === '--mds-skip-create') {
+        if (arg === "--mds-skip-create") {
             mds.skipCreate = true;
             continue;
         }
-        if (arg === '--mds-skip-expo-fix' || arg === '--mds-no-expo-fix') {
+        if (arg === "--mds-skip-expo-fix" || arg === "--mds-no-expo-fix") {
             mds.skipExpoFix = true;
             continue;
         }
-        if (arg.startsWith('--mds-create-expo-stack-bin=')) {
-            mds.createExpoStackBin = arg.slice('--mds-create-expo-stack-bin='.length);
+        if (arg.startsWith("--mds-create-expo-stack-bin=")) {
+            mds.createExpoStackBin = arg.slice("--mds-create-expo-stack-bin=".length);
             continue;
         }
-        if (arg === '--mds-guidelines-template') {
+        if (arg === "--mds-guidelines-template") {
             mds.guidelinesTemplate = true;
             continue;
         }
-        if (arg === '--mds-no-guidelines-template' || arg === '--mds-guidelines-template=false') {
+        if (arg === "--mds-no-guidelines-template" ||
+            arg === "--mds-guidelines-template=false") {
             mds.guidelinesTemplate = false;
             continue;
         }
-        if (arg.startsWith('--mds-guidelines-template=')) {
+        if (arg.startsWith("--mds-guidelines-template=")) {
             mds.guidelinesTemplate = true;
-            mds.guidelinesTemplatePath = arg.slice('--mds-guidelines-template='.length);
+            mds.guidelinesTemplatePath = arg.slice("--mds-guidelines-template=".length);
             continue;
         }
-        if (arg.startsWith('--mds-guidelines-template-path=')) {
+        if (arg.startsWith("--mds-guidelines-template-path=")) {
             mds.guidelinesTemplate = true;
-            mds.guidelinesTemplatePath = arg.slice('--mds-guidelines-template-path='.length);
+            mds.guidelinesTemplatePath = arg.slice("--mds-guidelines-template-path=".length);
             continue;
         }
-        if (arg.startsWith('--mds-defaults=')) {
-            mds.defaults = splitList(arg.slice('--mds-defaults='.length));
+        if (arg.startsWith("--mds-defaults=")) {
+            mds.defaults = splitList(arg.slice("--mds-defaults=".length));
             continue;
         }
-        if (arg.startsWith('--mds-app-name=')) {
-            mds.appName = arg.slice('--mds-app-name='.length);
+        if (arg.startsWith("--mds-app-name=")) {
+            mds.appName = arg.slice("--mds-app-name=".length);
             continue;
         }
-        if (arg.startsWith('--mds-audience=')) {
-            mds.audience = arg.slice('--mds-audience='.length);
+        if (arg.startsWith("--mds-audience=")) {
+            mds.audience = arg.slice("--mds-audience=".length);
             continue;
         }
-        if (arg.startsWith('--mds-core-flows=')) {
-            mds.coreFlows = arg.slice('--mds-core-flows='.length);
+        if (arg.startsWith("--mds-core-flows=")) {
+            mds.coreFlows = arg.slice("--mds-core-flows=".length);
             continue;
         }
-        if (arg.startsWith('--mds-screens=')) {
-            mds.screens = arg.slice('--mds-screens='.length);
+        if (arg.startsWith("--mds-screens=")) {
+            mds.screens = arg.slice("--mds-screens=".length);
             continue;
         }
-        if (arg.startsWith('--mds-data-needs=')) {
-            mds.dataNeeds = arg.slice('--mds-data-needs='.length);
+        if (arg.startsWith("--mds-data-needs=")) {
+            mds.dataNeeds = arg.slice("--mds-data-needs=".length);
             continue;
         }
-        if (arg.startsWith('--mds-data-start=')) {
-            const value = arg.slice('--mds-data-start='.length);
-            if (value === 'local' || value === 'supabase') {
+        if (arg.startsWith("--mds-data-start=")) {
+            const value = arg.slice("--mds-data-start=".length);
+            if (value === "local" || value === "supabase") {
                 mds.dataStart = value;
             }
             continue;
         }
-        if (arg.startsWith('--mds-deployment-target=')) {
-            mds.deploymentTarget = arg.slice('--mds-deployment-target='.length);
+        if (arg.startsWith("--mds-deployment-target=")) {
+            mds.deploymentTarget = arg.slice("--mds-deployment-target=".length);
             continue;
         }
-        if (arg === '--mds-test-to-main') {
+        if (arg === "--mds-test-to-main") {
             mds.testToMain = true;
             continue;
         }
-        if (arg === '--mds-no-test-to-main') {
+        if (arg === "--mds-no-test-to-main") {
             mds.testToMain = false;
             continue;
         }
-        if (arg.startsWith('--mds-platforms=')) {
-            mds.platforms = splitList(arg.slice('--mds-platforms='.length));
+        if (arg.startsWith("--mds-platforms=")) {
+            mds.platforms = splitList(arg.slice("--mds-platforms=".length));
             continue;
         }
-        if (arg.startsWith('--mds-first-platform=')) {
-            mds.firstPlatform = arg.slice('--mds-first-platform='.length);
+        if (arg.startsWith("--mds-first-platform=")) {
+            mds.firstPlatform = arg.slice("--mds-first-platform=".length);
             continue;
         }
-        if (arg.startsWith('--mds-platform-strategy=')) {
-            const value = arg.slice('--mds-platform-strategy='.length);
-            if (value === 'folders' || value === 'files-only') {
+        if (arg.startsWith("--mds-platform-strategy=")) {
+            const value = arg.slice("--mds-platform-strategy=".length);
+            if (value === "folders" || value === "files-only") {
                 mds.platformStrategy = value;
             }
             continue;
         }
-        if (arg.startsWith('--mds-app-directory=')) {
-            const value = arg.slice('--mds-app-directory='.length);
-            if (value === 'src' || value === 'root') {
+        if (arg.startsWith("--mds-app-directory=")) {
+            const value = arg.slice("--mds-app-directory=".length);
+            if (value === "src" || value === "root") {
                 mds.appDirectory = value;
             }
             continue;
         }
-        if (arg.startsWith('--mds-platform-layouts=')) {
-            const value = arg.slice('--mds-platform-layouts='.length);
-            if (value === 'shared' || value === 'platform-specific') {
+        if (arg.startsWith("--mds-platform-layouts=")) {
+            const value = arg.slice("--mds-platform-layouts=".length);
+            if (value === "shared" || value === "platform-specific") {
                 mds.platformLayouts = value;
             }
             continue;
         }
-        if (arg.startsWith('--mds-web-output=')) {
-            const value = arg.slice('--mds-web-output='.length);
-            if (value === 'static' || value === 'server' || value === 'spa' || value === 'none') {
+        if (arg.startsWith("--mds-web-output=")) {
+            const value = arg.slice("--mds-web-output=".length);
+            if (value === "static" ||
+                value === "server" ||
+                value === "spa" ||
+                value === "none") {
                 mds.webOutput = value;
             }
             continue;
         }
-        if (arg.startsWith('--mds-deployed-server=')) {
-            const value = arg.slice('--mds-deployed-server='.length);
-            if (value === 'standard-expo' || value === 'custom' || value === 'none') {
+        if (arg.startsWith("--mds-deployed-server=")) {
+            const value = arg.slice("--mds-deployed-server=".length);
+            if (value === "standard-expo" || value === "custom" || value === "none") {
                 mds.deployedServer = value;
             }
             continue;
         }
-        if (arg === '--mds-create-expo-components') {
+        if (arg === "--mds-create-expo-components") {
             mds.createExpoComponents = true;
             continue;
         }
-        if (arg === '--mds-no-create-expo-components') {
+        if (arg === "--mds-no-create-expo-components") {
             mds.createExpoComponents = false;
             continue;
         }
-        if (arg === '--mds-latest-expo-sdk') {
-            mds.latestExpoSdk = true;
-            continue;
-        }
-        if (arg === '--mds-no-latest-expo-sdk') {
-            mds.latestExpoSdk = false;
+        if (arg === "--mds-latest-expo-sdk" || arg === "--mds-no-latest-expo-sdk") {
             continue;
         }
-        if (arg === '--mds-expo-ui') {
+        if (arg === "--mds-expo-ui") {
             mds.expoUi = true;
             continue;
         }
-        if (arg === '--mds-no-expo-ui') {
+        if (arg === "--mds-no-expo-ui") {
             mds.expoUi = false;
             continue;
         }
-        if (arg === '--mds-expo-ui-universal') {
+        if (arg === "--mds-expo-ui-universal") {
             mds.expoUiUniversal = true;
             continue;
         }
-        if (arg === '--mds-no-expo-ui-universal') {
+        if (arg === "--mds-no-expo-ui-universal") {
             mds.expoUiUniversal = false;
             continue;
         }
-        if (arg === '--mds-expo-native-tabs') {
+        if (arg === "--mds-expo-native-tabs") {
             mds.expoNativeTabs = true;
             continue;
         }
-        if (arg === '--mds-no-expo-native-tabs') {
+        if (arg === "--mds-no-expo-native-tabs") {
             mds.expoNativeTabs = false;
             continue;
         }
-        if (arg.startsWith('--mds-eas-uses=')) {
-            mds.easUses = splitList(arg.slice('--mds-eas-uses='.length));
+        if (arg.startsWith("--mds-eas-uses=")) {
+            mds.easUses = splitList(arg.slice("--mds-eas-uses=".length));
             continue;
         }
         createExpoStackArgs.push(arg);
@@ -354,33 +377,33 @@ export function parseArgs(args) {
 }
 export function renderHelpText() {
     return [
-        'create-expo-super-stack',
-        '',
-        'Usage:',
-        '  create-expo-super-stack [project-name] [create-expo-stack options] [mds options]',
-        '',
-        'Examples:',
-        '  create-expo-super-stack my-app --expo-router --uniwind',
-        '  create-expo-super-stack ../MyApp --expo-router --mds-yes',
-        '',
-        'Common mds options:',
-        '  --mds-yes                     Run non-interactive onboarding defaults',
-        '  --mds-save-defaults           Save onboarding answers as personal defaults',
-        '  --mds-no-save-defaults        Do not save onboarding answers as personal defaults',
-        '  --mds-skip-create             Skip create-expo-stack and only run onboarding in an existing app',
-        '  --mds-skip-expo-fix           Skip dependency install/fix/doctor repair pass',
-        '  --mds-guidelines-template     Use bundled MDS project/guidelines template',
-        '  --mds-no-guidelines-template  Do not use the bundled MDS project/guidelines template',
-        '  --mds-app-name=<name>         Set display app name for project memory',
-        '  --mds-screens=                List must-include screens for project memory',
-        '  --mds-expo-ui-universal       Use Expo UI Universal components when Expo UI is selected',
-        '',
-        'Help:',
-        '  -h, --help                     Show this help and exit',
-        '',
-        'Note:',
-        '  Unknown non-mds flags are forwarded to create-expo-stack.',
-    ].join('\n');
+        "create-expo-super-stack",
+        "",
+        "Usage:",
+        "  create-expo-super-stack [project-name] [create-expo-stack options] [mds options]",
+        "",
+        "Examples:",
+        "  create-expo-super-stack my-app --expo-router --uniwind",
+        "  create-expo-super-stack ../MyApp --expo-router --mds-yes",
+        "",
+        "Common mds options:",
+        "  --mds-yes                     Run non-interactive onboarding defaults",
+        "  --mds-save-defaults           Save onboarding answers as personal defaults",
+        "  --mds-no-save-defaults        Do not save onboarding answers as personal defaults",
+        "  --mds-skip-create             Skip create-expo-stack and only run onboarding in an existing app",
+        "  --mds-skip-expo-fix           Skip dependency install/fix/doctor repair pass",
+        "  --mds-guidelines-template     Use bundled MDS project/guidelines template",
+        "  --mds-no-guidelines-template  Do not use the bundled MDS project/guidelines template",
+        "  --mds-app-name=<name>         Set display app name for project memory",
+        "  --mds-screens=                List must-include screens for project memory",
+        "  --mds-expo-ui-universal       Use Expo UI Universal components when Expo UI is selected",
+        "",
+        "Help:",
+        "  -h, --help                     Show this help and exit",
+        "",
+        "Note:",
+        "  Unknown non-mds flags are forwarded to create-expo-stack.",
+    ].join("\n");
 }
 export function withResolvedProjectName(parsed, projectName) {
     const target = resolveProjectTarget(parsed.projectName ?? projectName);
@@ -419,18 +442,18 @@ async function promptForMissingProjectName(parsed) {
         return DEFAULT_PROJECT_NAME;
     }
     const answer = await text({
-        message: 'What do you want to name your Expo app?',
+        message: "What is the name of your app?",
         placeholder: DEFAULT_PROJECT_NAME,
         defaultValue: DEFAULT_PROJECT_NAME,
         validate: (value) => {
             if (!value.trim()) {
-                return 'Please enter an app name, or press Enter to use the visible default.';
+                return "Please enter an app name, or press Enter to use the visible default.";
             }
             return undefined;
         },
     });
     if (isCancel(answer)) {
-        cancel('Cancelled. You can rerun create-expo-super-stack whenever you are ready.');
+        cancel("Cancelled. You can rerun create-expo-super-stack whenever you are ready.");
         process.exit(0);
     }
     const projectName = answer.trim() || DEFAULT_PROJECT_NAME;
@@ -438,9 +461,9 @@ async function promptForMissingProjectName(parsed) {
     return projectName;
 }
 function printIntro(projectName, createExpoStackArgs, projectParentDir = process.cwd()) {
-    console.log('create-expo-super-stack');
+    console.log("create-expo-super-stack");
     console.log();
-    console.log('This uses create-expo-stack under the hood, then applies MDS onboarding.');
+    console.log("This uses create-expo-stack under the hood, then applies MDS onboarding.");
     console.log(`Delegating: create-expo-stack ${formatDisplayArgs(createExpoStackArgs)}`);
     console.log(`Target app: ${projectName}`);
     if (projectParentDir !== process.cwd()) {
@@ -454,25 +477,27 @@ async function runCreateExpoStack(args, overrideBin, cwd = process.cwd()) {
     await new Promise((resolve, reject) => {
         const child = spawn(command.command, [...command.args, ...args], {
             cwd,
-            shell: command.shell ?? process.platform === 'win32',
-            stdio: 'inherit',
+            shell: command.shell ?? process.platform === "win32",
+            stdio: "inherit",
             windowsHide: true,
         });
-        child.on('error', reject);
-        child.on('close', (code) => {
+        child.on("error", reject);
+        child.on("close", (code) => {
             if (code === 0) {
                 resolve();
             }
             else {
-                reject(new Error(`create-expo-stack exited with code ${code ?? 'unknown'}.`));
+                reject(new Error(`create-expo-stack exited with code ${code ?? "unknown"}.`));
             }
         });
     });
 }
 export function resolveProjectTarget(rawProjectName, cwd = process.cwd()) {
     const trimmed = rawProjectName.trim();
-    const normalized = trimmed.replace(/[\\/]+$/u, '') || DEFAULT_PROJECT_NAME;
-    const hasPathSyntax = path.isAbsolute(normalized) || normalized.includes('/') || normalized.includes('\\');
+    const normalized = trimmed.replace(/[\\/]+$/u, "") || DEFAULT_PROJECT_NAME;
+    const hasPathSyntax = path.isAbsolute(normalized) ||
+        normalized.includes("/") ||
+        normalized.includes("\\");
     if (!hasPathSyntax) {
         return {
             projectName: normalized,
@@ -488,7 +513,7 @@ export function resolveProjectTarget(rawProjectName, cwd = process.cwd()) {
 }
 function replaceProjectArg(args, projectName) {
     const nextArgs = [...args];
-    const projectArgIndex = nextArgs.findIndex((arg) => !arg.startsWith('--'));
+    const projectArgIndex = nextArgs.findIndex((arg) => !arg.startsWith("--"));
     if (projectArgIndex >= 0) {
         nextArgs[projectArgIndex] = projectName;
         return nextArgs;
@@ -496,27 +521,24 @@ function replaceProjectArg(args, projectName) {
     return [projectName, ...nextArgs];
 }
 export function validateCreateExpoStackArgs(args) {
-    const authFlags = ['--supabase', '--firebase'].filter((flag) => args.some((arg) => arg === flag || arg.startsWith(`${flag}=`)));
+    const authFlags = ["--supabase", "--firebase"].filter((flag) => args.some((arg) => arg === flag || arg.startsWith(`${flag}=`)));
     if (authFlags.length > 1) {
-        throw new Error(`Choose one create-expo-stack auth provider, not ${authFlags.join(' and ')}. create-expo-stack scaffolds a single auth slice; Super Stack can still document future data/backend plans in project/.`);
+        throw new Error(`Choose one create-expo-stack auth provider, not ${authFlags.join(" and ")}. create-expo-stack scaffolds a single auth slice; Super Stack can still document future data/backend plans in project/.`);
     }
 }
-export async function runExpoProjectChecks(projectPath, packageManager, options = {}) {
+export async function runExpoProjectChecks(projectPath, packageManager) {
     console.log();
-    console.log('Installing MDS-added dependencies, then running Expo dependency repair and doctor.');
+    console.log("Installing MDS-added dependencies, then running Expo dependency repair and doctor.");
     await runProjectCommand(projectPath, buildInstallCommand(packageManager));
     const missingWindowsOxideBinding = await resolveMissingWindowsTailwindOxideBinding(projectPath);
     if (missingWindowsOxideBinding) {
         await runProjectCommand(projectPath, buildAddDevDependencyCommand(packageManager, missingWindowsOxideBinding));
     }
-    if (options.useLatestExpoSdk && (await shouldRunExpoLatestSdkCommand(projectPath))) {
+    if (await shouldRunExpoLatestSdkCommand(projectPath)) {
         await runProjectCommand(projectPath, buildExpoLatestSdkCommand(packageManager));
     }
-    else if (options.useLatestExpoSdk) {
-        console.log(`  Expo SDK already targets SDK ${CURRENT_EXPO_SDK_MAJOR}; skipping expo@latest.`);
-    }
-    if (await shouldRunExpoPinnedSdkCommand(projectPath)) {
-        await runProjectCommand(projectPath, buildExpoPinnedSdkCommand(packageManager));
+    else {
+        console.log(`  Expo already targets SDK ${EXPECTED_EXPO_SDK_MAJOR}; skipping expo install expo@^${EXPECTED_EXPO_SDK_MAJOR}.`);
     }
     await runProjectCommand(projectPath, buildExpoInstallFixCommand(packageManager));
     if (await shouldInstallExpoFontPeer(projectPath)) {
@@ -530,26 +552,30 @@ async function runProjectCommand(projectPath, spec) {
     await new Promise((resolve, reject) => {
         const child = spawn(spec.command, spec.args, {
             cwd: projectPath,
-            shell: spec.shell ?? process.platform === 'win32',
-            stdio: 'inherit',
+            shell: spec.shell ?? process.platform === "win32",
+            stdio: "inherit",
             env: spec.env ? { ...process.env, ...spec.env } : process.env,
             windowsHide: true,
         });
-        child.on('error', reject);
-        child.on('close', (code) => {
+        child.on("error", reject);
+        child.on("close", (code) => {
             if (code === 0) {
                 resolve();
             }
             else {
-                reject(new Error(`${spec.display} exited with code ${code ?? 'unknown'}.`));
+                reject(new Error(`${spec.display} exited with code ${code ?? "unknown"}.`));
             }
         });
     });
 }
 async function resolveCreateExpoStackCommand(overrideBin) {
-    const packageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
-    const executable = process.platform === 'win32' ? 'create-expo-stack.cmd' : 'create-expo-stack';
-    const override = overrideBin ?? process.env.MRDJ_CREATE_EXPO_STACK_BIN ?? process.env.CREATE_EXPO_STACK_BIN;
+    const packageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+    const executable = process.platform === "win32"
+        ? "create-expo-stack.cmd"
+        : "create-expo-stack";
+    const override = overrideBin ??
+        process.env.MRDJ_CREATE_EXPO_STACK_BIN ??
+        process.env.CREATE_EXPO_STACK_BIN;
     if (override) {
         const overridePath = path.resolve(override);
         return {
@@ -559,8 +585,8 @@ async function resolveCreateExpoStackCommand(overrideBin) {
             shell: false,
         };
     }
-    const localForkCliRoot = path.join(packageRoot, '..', '..', '..', 'create-expo-stack', 'cli');
-    const localForkBin = path.join(localForkCliRoot, 'bin', 'create-expo-stack.js');
+    const localForkCliRoot = path.join(packageRoot, "..", "..", "..", "create-expo-stack", "cli");
+    const localForkBin = path.join(localForkCliRoot, "bin", "create-expo-stack.js");
     if (await pathExists(localForkBin)) {
         await ensureLocalCreateExpoStackBuild(localForkCliRoot);
         return {
@@ -571,8 +597,8 @@ async function resolveCreateExpoStackCommand(overrideBin) {
         };
     }
     const scopedForkCandidates = [
-        path.join(packageRoot, 'node_modules', '@mr.dj2u', 'create-expo-stack', 'bin', 'create-expo-stack.js'),
-        path.join(packageRoot, '..', '..', 'node_modules', '@mr.dj2u', 'create-expo-stack', 'bin', 'create-expo-stack.js'),
+        path.join(packageRoot, "node_modules", "@mr.dj2u", "create-expo-stack", "bin", "create-expo-stack.js"),
+        path.join(packageRoot, "..", "..", "node_modules", "@mr.dj2u", "create-expo-stack", "bin", "create-expo-stack.js"),
     ];
     for (const candidate of scopedForkCandidates) {
         if (await pathExists(candidate)) {
@@ -585,8 +611,8 @@ async function resolveCreateExpoStackCommand(overrideBin) {
         }
     }
     const candidates = [
-        path.join(packageRoot, 'node_modules', '.bin', executable),
-        path.join(packageRoot, '..', '..', 'node_modules', '.bin', executable),
+        path.join(packageRoot, "node_modules", ".bin", executable),
+        path.join(packageRoot, "..", "..", "node_modules", ".bin", executable),
     ];
     for (const candidate of candidates) {
         if (await pathExists(candidate)) {
@@ -598,58 +624,65 @@ async function resolveCreateExpoStackCommand(overrideBin) {
         }
     }
     return {
-        command: 'create-expo-stack',
+        command: "create-expo-stack",
         args: [],
-        display: 'create-expo-stack',
+        display: "create-expo-stack",
     };
 }
 async function ensureLocalCreateExpoStackBuild(localForkCliRoot) {
-    const buildEntry = path.join(localForkCliRoot, 'build', 'cli.js');
+    const buildEntry = path.join(localForkCliRoot, "build", "cli.js");
     if (await pathExists(buildEntry)) {
         return;
     }
     console.log(`Building local create-expo-stack fork: ${localForkCliRoot}`);
-    if (await commandExists('bun')) {
+    if (await commandExists("bun")) {
         await runProjectCommand(localForkCliRoot, {
-            command: 'bun',
-            args: ['run', 'build'],
-            display: 'bun run build',
+            command: "bun",
+            args: ["run", "build"],
+            display: "bun run build",
         });
         return;
     }
-    console.log('Bun was not found, so using npm to build the local fork.');
-    if (!(await pathExists(path.join(localForkCliRoot, 'node_modules')))) {
+    console.log("Bun was not found, so using npm to build the local fork.");
+    if (!(await pathExists(path.join(localForkCliRoot, "node_modules")))) {
         await runProjectCommand(localForkCliRoot, {
-            command: 'npm',
-            args: ['install'],
-            display: 'npm install',
+            command: "npm",
+            args: ["install"],
+            display: "npm install",
         });
     }
     await runProjectCommand(localForkCliRoot, {
-        command: 'npx',
-        args: ['tsc', '-p', '.'],
-        display: 'npx tsc -p .',
+        command: "npx",
+        args: ["tsc", "-p", "."],
+        display: "npx tsc -p .",
     });
     await runProjectCommand(localForkCliRoot, {
-        command: 'npx',
-        args: ['copyfiles', '-u', '2', '-a', './src/templates/**/*', './build/templates'],
+        command: "npx",
+        args: [
+            "copyfiles",
+            "-u",
+            "2",
+            "-a",
+            "./src/templates/**/*",
+            "./build/templates",
+        ],
         display: 'npx copyfiles -u 2 -a "./src/templates/**/*" ./build/templates',
     });
 }
 async function commandExists(command) {
     return new Promise((resolve) => {
-        const child = spawn(command, ['--version'], {
-            shell: process.platform === 'win32',
-            stdio: 'ignore',
+        const child = spawn(command, ["--version"], {
+            shell: process.platform === "win32",
+            stdio: "ignore",
             windowsHide: true,
         });
-        child.on('error', () => resolve(false));
-        child.on('close', (code) => resolve(code === 0));
+        child.on("error", () => resolve(false));
+        child.on("close", (code) => resolve(code === 0));
     });
 }
 async function resolveGeneratedProjectPath(cwd, projectName) {
     const directPath = path.resolve(cwd, projectName);
-    if (await pathExists(path.join(directPath, 'package.json'))) {
+    if (await pathExists(path.join(directPath, "package.json"))) {
         return directPath;
     }
     const fromCesConfig = await findProjectFromCesConfig(cwd, projectName);
@@ -659,8 +692,8 @@ async function resolveGeneratedProjectPath(cwd, projectName) {
     return directPath;
 }
 async function moveRootAppIntoSrc(projectPath) {
-    const rootAppDir = path.join(projectPath, 'app');
-    const srcAppDir = path.join(projectPath, 'src', 'app');
+    const rootAppDir = path.join(projectPath, "app");
+    const srcAppDir = path.join(projectPath, "src", "app");
     if (!(await pathExists(rootAppDir)) || (await pathExists(srcAppDir))) {
         return null;
     }
@@ -669,14 +702,14 @@ async function moveRootAppIntoSrc(projectPath) {
     return { from: rootAppDir, to: srcAppDir };
 }
 async function consolidateRootSourceFolders(projectPath) {
-    const folderNames = ['components', 'theme', 'lib'];
+    const folderNames = ["components", "theme", "lib"];
     const updatedPaths = [];
     for (const folderName of folderNames) {
         const rootDir = path.join(projectPath, folderName);
         if (!(await pathExists(rootDir))) {
             continue;
         }
-        const srcDir = path.join(projectPath, 'src', folderName);
+        const srcDir = path.join(projectPath, "src", folderName);
         if (!(await pathExists(srcDir))) {
             await mkdir(path.dirname(srcDir), { recursive: true });
             await rename(rootDir, srcDir);
@@ -710,7 +743,7 @@ async function mergeDirectoryInto(sourceDir, targetDir) {
 export async function repairMovedSrcAppImports(projectPath) {
     const layoutPaths = [
         {
-            filePath: path.join(projectPath, 'src', 'app', '(tabs)', '_layout.tsx'),
+            filePath: path.join(projectPath, "src", "app", "(tabs)", "_layout.tsx"),
             replacements: [
                 ['"../components/HeaderButton"', '"../../components/HeaderButton"'],
                 ['"../components/TabBarIcon"', '"../../components/TabBarIcon"'],
@@ -719,7 +752,7 @@ export async function repairMovedSrcAppImports(projectPath) {
             ],
         },
         {
-            filePath: path.join(projectPath, 'src', 'app', '(drawer)', '_layout.tsx'),
+            filePath: path.join(projectPath, "src", "app", "(drawer)", "_layout.tsx"),
             replacements: [
                 ['"../components/HeaderButton"', '"../../components/HeaderButton"'],
                 ['"../components/TabBarIcon"', '"../../components/TabBarIcon"'],
@@ -728,11 +761,17 @@ export async function repairMovedSrcAppImports(projectPath) {
             ],
         },
         {
-            filePath: path.join(projectPath, 'src', 'app', '(drawer)', '(tabs)', '_layout.tsx'),
+            filePath: path.join(projectPath, "src", "app", "(drawer)", "(tabs)", "_layout.tsx"),
             replacements: [
-                ['"../../components/HeaderButton"', '"../../../components/HeaderButton"'],
+                [
+                    '"../../components/HeaderButton"',
+                    '"../../../components/HeaderButton"',
+                ],
                 ['"../../components/TabBarIcon"', '"../../../components/TabBarIcon"'],
-                ["'../../components/HeaderButton'", "'../../../components/HeaderButton'"],
+                [
+                    "'../../components/HeaderButton'",
+                    "'../../../components/HeaderButton'",
+                ],
                 ["'../../components/TabBarIcon'", "'../../../components/TabBarIcon'"],
             ],
         },
@@ -750,7 +789,7 @@ export async function repairMovedSrcAppImports(projectPath) {
         if (updated === raw) {
             continue;
         }
-        await writeFile(layout.filePath, updated, 'utf8');
+        await writeFile(layout.filePath, updated, "utf8");
         updatedPaths.push(layout.filePath);
     }
     return updatedPaths;
@@ -759,8 +798,10 @@ export async function repairGeneratedTypeSupport(projectPath, options = {}) {
     const updatedPaths = new Set();
     let shouldIncludeUniwindTypes = false;
     if (options.needsUniwindTypes) {
-        const packageJson = await readJson(path.join(projectPath, 'package.json'));
-        const dependencies = isRecord(packageJson.dependencies) ? packageJson.dependencies : {};
+        const packageJson = await readJson(path.join(projectPath, "package.json"));
+        const dependencies = isRecord(packageJson.dependencies)
+            ? packageJson.dependencies
+            : {};
         const devDependencies = isRecord(packageJson.devDependencies)
             ? packageJson.devDependencies
             : {};
@@ -768,95 +809,97 @@ export async function repairGeneratedTypeSupport(projectPath, options = {}) {
             ? packageJson.optionalDependencies
             : {};
         shouldIncludeUniwindTypes =
-            typeof dependencies.uniwind === 'string' ||
-                typeof devDependencies.uniwind === 'string' ||
-                typeof optionalDependencies.uniwind === 'string' ||
-                (await pathExists(path.join(projectPath, 'node_modules', 'uniwind', 'types.d.ts'))) ||
-                (await pathExists(path.join(projectPath, 'node_modules', 'uniwind', 'types', 'index.d.ts')));
+            typeof dependencies.uniwind === "string" ||
+                typeof devDependencies.uniwind === "string" ||
+                typeof optionalDependencies.uniwind === "string" ||
+                (await pathExists(path.join(projectPath, "node_modules", "uniwind", "types.d.ts"))) ||
+                (await pathExists(path.join(projectPath, "node_modules", "uniwind", "types", "index.d.ts")));
     }
     if (options.needsUniwindTypes) {
-        const cssEnvPath = path.join(projectPath, 'css-env.d.ts');
-        const raw = (await readOptionalText(cssEnvPath)) ?? '';
-        if (shouldIncludeUniwindTypes && !raw.includes('uniwind/types')) {
-            await writeFile(cssEnvPath, `/// <reference types="uniwind/types" />\n\n${raw}`, 'utf8');
+        const cssEnvPath = path.join(projectPath, "css-env.d.ts");
+        const raw = (await readOptionalText(cssEnvPath)) ?? "";
+        if (shouldIncludeUniwindTypes && !raw.includes("uniwind/types")) {
+            await writeFile(cssEnvPath, `/// <reference types="uniwind/types" />\n\n${raw}`, "utf8");
             updatedPaths.add(cssEnvPath);
         }
-        else if (!shouldIncludeUniwindTypes && raw.includes('uniwind/types')) {
+        else if (!shouldIncludeUniwindTypes && raw.includes("uniwind/types")) {
             const updated = raw
-                .replace(/^\/\/\/ <reference types="uniwind\/types" \/>\r?\n\r?\n?/m, '')
+                .replace(/^\/\/\/ <reference types="uniwind\/types" \/>\r?\n\r?\n?/m, "")
                 .trimStart();
-            await writeFile(cssEnvPath, updated, 'utf8');
+            await writeFile(cssEnvPath, updated, "utf8");
             updatedPaths.add(cssEnvPath);
         }
     }
     if (options.needsNodeTypes || options.needsUniwindTypes) {
-        const tsconfigPath = path.join(projectPath, 'tsconfig.json');
+        const tsconfigPath = path.join(projectPath, "tsconfig.json");
         const tsconfig = await readJson(tsconfigPath);
-        const compilerOptions = isRecord(tsconfig.compilerOptions) ? tsconfig.compilerOptions : {};
-        const pathsConfig = isRecord(compilerOptions.paths) ? compilerOptions.paths : {};
-        const usingSrcApp = await pathExists(path.join(projectPath, 'src', 'app'));
+        const compilerOptions = isRecord(tsconfig.compilerOptions)
+            ? tsconfig.compilerOptions
+            : {};
+        const pathsConfig = isRecord(compilerOptions.paths)
+            ? compilerOptions.paths
+            : {};
+        const usingSrcApp = await pathExists(path.join(projectPath, "src", "app"));
         const normalizedPathsConfig = usingSrcApp
             ? await normalizeTsconfigPathsForSrcDirectory(projectPath, pathsConfig)
             : pathsConfig;
-        const hasAliasPaths = Object.keys(pathsConfig).some((key) => key.includes('@'));
         const existingTypes = Array.isArray(compilerOptions.types)
-            ? compilerOptions.types.filter((item) => typeof item === 'string')
+            ? compilerOptions.types.filter((item) => typeof item === "string")
             : [];
         const currentTypes = existingTypes
-            ? existingTypes.filter((item) => shouldIncludeUniwindTypes || item !== 'uniwind/types')
+            ? existingTypes.filter((item) => shouldIncludeUniwindTypes || item !== "uniwind/types")
             : [];
         const desiredTypes = [
             ...currentTypes,
-            ...(options.needsNodeTypes ? ['node'] : []),
-            ...(shouldIncludeUniwindTypes ? ['uniwind/types'] : []),
+            ...(options.needsNodeTypes ? ["node"] : []),
+            ...(shouldIncludeUniwindTypes ? ["uniwind/types"] : []),
         ];
         const nextTypes = Array.from(new Set(desiredTypes));
-        const shouldSetBaseUrl = hasAliasPaths && typeof compilerOptions.baseUrl !== 'string';
-        const shouldSetIgnoreDeprecations = (shouldSetBaseUrl || typeof compilerOptions.baseUrl === 'string') &&
-            compilerOptions.ignoreDeprecations !== '6.0';
+        const shouldRemoveDeprecatedTsconfigOptions = "baseUrl" in compilerOptions || "ignoreDeprecations" in compilerOptions;
         const shouldUpdatePaths = JSON.stringify(pathsConfig) !== JSON.stringify(normalizedPathsConfig);
         const shouldUpdateTypes = JSON.stringify(existingTypes) !== JSON.stringify(nextTypes);
-        if (shouldUpdateTypes || shouldSetBaseUrl || shouldSetIgnoreDeprecations || shouldUpdatePaths) {
+        if (shouldUpdateTypes ||
+            shouldRemoveDeprecatedTsconfigOptions ||
+            shouldUpdatePaths) {
+            const { baseUrl: _baseUrl, ignoreDeprecations: _ignoreDeprecations, ...compilerOptionsWithoutDeprecatedOptions } = compilerOptions;
             tsconfig.compilerOptions = {
-                ...compilerOptions,
+                ...compilerOptionsWithoutDeprecatedOptions,
                 ...(shouldUpdatePaths ? { paths: normalizedPathsConfig } : {}),
                 types: shouldUpdateTypes ? nextTypes : currentTypes,
-                ...(shouldSetBaseUrl ? { baseUrl: '.' } : {}),
-                ...(shouldSetIgnoreDeprecations ? { ignoreDeprecations: '6.0' } : {}),
             };
-            await writeFile(tsconfigPath, `${JSON.stringify(tsconfig, null, 2)}\n`, 'utf8');
+            await writeFile(tsconfigPath, `${JSON.stringify(tsconfig, null, 2)}\n`, "utf8");
             updatedPaths.add(tsconfigPath);
         }
     }
     if (options.needsNodeTypes) {
-        const packageJsonPath = path.join(projectPath, 'package.json');
+        const packageJsonPath = path.join(projectPath, "package.json");
         const packageJson = await readJson(packageJsonPath);
         const devDependencies = isRecord(packageJson.devDependencies)
             ? packageJson.devDependencies
             : {};
-        if (devDependencies['@types/node'] !== '^25.9.1') {
+        if (devDependencies["@types/node"] !== "^25.9.1") {
             packageJson.devDependencies = {
                 ...devDependencies,
-                '@types/node': '^25.9.1',
+                "@types/node": "^25.9.1",
             };
-            await writeFile(packageJsonPath, `${JSON.stringify(packageJson, null, 2)}\n`, 'utf8');
+            await writeFile(packageJsonPath, `${JSON.stringify(packageJson, null, 2)}\n`, "utf8");
             updatedPaths.add(packageJsonPath);
         }
     }
     const tabBarIconPaths = [
-        path.join(projectPath, 'components', 'TabBarIcon.tsx'),
-        path.join(projectPath, 'src', 'components', 'TabBarIcon.tsx'),
+        path.join(projectPath, "components", "TabBarIcon.tsx"),
+        path.join(projectPath, "src", "components", "TabBarIcon.tsx"),
     ];
     for (const tabBarIconPath of tabBarIconPaths) {
         const tabBarIconRaw = await readOptionalText(tabBarIconPath);
-        if (!tabBarIconRaw || !tabBarIconRaw.includes('color: string')) {
+        if (!tabBarIconRaw || !tabBarIconRaw.includes("color: string")) {
             continue;
         }
         const updated = tabBarIconRaw
             .replace("import { StyleSheet } from 'react-native';", "import type { ColorValue } from 'react-native';\nimport { StyleSheet } from 'react-native';")
-            .replace('color: string;', 'color: ColorValue;');
+            .replace("color: string;", "color: ColorValue;");
         if (updated !== tabBarIconRaw) {
-            await writeFile(tabBarIconPath, updated, 'utf8');
+            await writeFile(tabBarIconPath, updated, "utf8");
             updatedPaths.add(tabBarIconPath);
         }
     }
@@ -871,7 +914,7 @@ async function normalizeTsconfigPathsForSrcDirectory(projectPath, pathsConfig) {
         }
         const nextTargets = [];
         for (const target of targets) {
-            if (typeof target !== 'string') {
+            if (typeof target !== "string") {
                 nextTargets.push(target);
                 continue;
             }
@@ -883,23 +926,27 @@ async function normalizeTsconfigPathsForSrcDirectory(projectPath, pathsConfig) {
     return nextPaths;
 }
 async function normalizeAliasTargetForSrcDirectory(projectPath, alias, target) {
-    const normalizedTarget = target.replace(/\\/g, '/').trim();
-    if (normalizedTarget.startsWith('./src/') || normalizedTarget.startsWith('src/')) {
+    const normalizedTarget = target.replace(/\\/g, "/").trim();
+    if (normalizedTarget.startsWith("./src/") ||
+        normalizedTarget.startsWith("src/")) {
         return target;
     }
-    if (alias === '@/*' && (normalizedTarget === './*' || normalizedTarget === '*')) {
-        return './src/*';
+    if (alias === "@/*" &&
+        (normalizedTarget === "./*" || normalizedTarget === "*")) {
+        return "./src/*";
     }
-    const relativeTarget = normalizedTarget.startsWith('./')
+    const relativeTarget = normalizedTarget.startsWith("./")
         ? normalizedTarget.slice(2)
         : normalizedTarget;
-    const wildcardSuffix = relativeTarget.endsWith('/*') ? '/*' : '';
-    const relativeBase = wildcardSuffix ? relativeTarget.slice(0, -2) : relativeTarget;
-    if (!relativeBase || relativeBase === '*') {
+    const wildcardSuffix = relativeTarget.endsWith("/*") ? "/*" : "";
+    const relativeBase = wildcardSuffix
+        ? relativeTarget.slice(0, -2)
+        : relativeTarget;
+    if (!relativeBase || relativeBase === "*") {
         return target;
     }
     const rootCandidate = path.join(projectPath, relativeBase);
-    const srcCandidate = path.join(projectPath, 'src', relativeBase);
+    const srcCandidate = path.join(projectPath, "src", relativeBase);
     const rootExists = await pathExists(rootCandidate);
     const srcExists = await pathExists(srcCandidate);
     if (!rootExists && srcExists) {
@@ -909,28 +956,41 @@ async function normalizeAliasTargetForSrcDirectory(projectPath, alias, target) {
 }
 export async function repairGeneratedNativeWindUiPicker(projectPath) {
     const pickerPaths = [
-        path.join(projectPath, 'components', 'nativewindui', 'Picker.tsx'),
-        path.join(projectPath, 'src', 'components', 'nativewindui', 'Picker.tsx'),
+        path.join(projectPath, "components", "nativewindui", "Picker.tsx"),
+        path.join(projectPath, "src", "components", "nativewindui", "Picker.tsx"),
     ];
     const updatedPaths = [];
     for (const pickerPath of pickerPaths) {
         const raw = await readOptionalText(pickerPath);
-        if (!raw || !raw.includes('dropdownIconRippleColor=')) {
+        if (!raw || !raw.includes("dropdownIconRippleColor=")) {
             continue;
         }
         let updated = raw;
         updated = updated.replace("import { View } from 'react-native';", "import { Platform, View } from 'react-native';");
-        updated = updated.replace('        dropdownIconRippleColor={dropdownIconRippleColor ?? colors.foreground}', "        {...(Platform.OS === 'web' ? {} : { dropdownIconRippleColor: dropdownIconRippleColor ?? colors.foreground })}");
+        updated = updated.replace("        dropdownIconRippleColor={dropdownIconRippleColor ?? colors.foreground}", "        {...(Platform.OS === 'web' ? {} : { dropdownIconRippleColor: dropdownIconRippleColor ?? colors.foreground })}");
         if (updated === raw) {
             continue;
         }
-        await writeFile(pickerPath, updated, 'utf8');
+        await writeFile(pickerPath, updated, "utf8");
         updatedPaths.push(pickerPath);
     }
     return updatedPaths;
 }
+export async function repairGeneratedEslintConfig(projectPath) {
+    const eslintConfigPath = path.join(projectPath, "eslint.config.js");
+    const raw = await readOptionalText(eslintConfigPath);
+    if (!raw) {
+        return [];
+    }
+    const updated = raw.replace(/^\/\* eslint-env node \*\/\r?\n/, "");
+    if (updated === raw) {
+        return [];
+    }
+    await writeFile(eslintConfigPath, updated, "utf8");
+    return [eslintConfigPath];
+}
 export async function repairExpoProjectIdentifiers(projectPath, projectName, targetPlatforms = []) {
-    const appJsonPath = path.join(projectPath, 'app.json');
+    const appJsonPath = path.join(projectPath, "app.json");
     const raw = await readOptionalText(appJsonPath);
     if (!raw) {
         return [];
@@ -949,7 +1009,7 @@ export async function repairExpoProjectIdentifiers(projectPath, projectName, tar
     }
     const nextSlug = toExpoSlug(readString(expo.slug) ?? projectName);
     const currentScheme = expo.scheme;
-    const hasScheme = Object.prototype.hasOwnProperty.call(expo, 'scheme');
+    const hasScheme = Object.prototype.hasOwnProperty.call(expo, "scheme");
     const nextScheme = hasScheme
         ? Array.isArray(currentScheme)
             ? currentScheme.map((item) => toExpoScheme(readString(item) ?? projectName))
@@ -960,54 +1020,59 @@ export async function repairExpoProjectIdentifiers(projectPath, projectName, tar
         expo.slug = nextSlug;
         changed = true;
     }
-    if (hasScheme && JSON.stringify(currentScheme) !== JSON.stringify(nextScheme)) {
+    if (hasScheme &&
+        JSON.stringify(currentScheme) !== JSON.stringify(nextScheme)) {
         expo.scheme = nextScheme;
         changed = true;
     }
-    const shouldIncludeWeb = targetPlatforms.includes('web');
     const currentPlatforms = Array.isArray(expo.platforms) ? expo.platforms : [];
-    if (shouldIncludeWeb && !currentPlatforms.includes('web')) {
-        expo.platforms = [...currentPlatforms, 'web'];
+    const normalizedTargetPlatforms = Array.from(new Set(targetPlatforms
+        .map((platform) => readString(platform) ?? platform)
+        .filter((platform) => Boolean(platform))));
+    if (normalizedTargetPlatforms.length > 0 &&
+        JSON.stringify(currentPlatforms) !== JSON.stringify(normalizedTargetPlatforms)) {
+        expo.platforms = normalizedTargetPlatforms;
         changed = true;
     }
-    const shouldIncludeAndroid = targetPlatforms.includes('android');
+    const shouldIncludeAndroid = targetPlatforms.includes("android");
     if (shouldIncludeAndroid) {
-        if (readString(expo.backgroundColor) !== '#f1f0f8') {
-            expo.backgroundColor = '#f1f0f8';
+        if (readString(expo.backgroundColor) !== "#f1f0f8") {
+            expo.backgroundColor = "#f1f0f8";
             changed = true;
         }
         const androidConfig = isRecord(expo.android) ? { ...expo.android } : {};
-        if (readString(androidConfig.backgroundColor) !== '#f1f0f8') {
-            androidConfig.backgroundColor = '#f1f0f8';
+        if (readString(androidConfig.backgroundColor) !== "#f1f0f8") {
+            androidConfig.backgroundColor = "#f1f0f8";
             expo.android = androidConfig;
             changed = true;
         }
         const desiredAndroidStatusBar = {
-            backgroundColor: '#f1f0f8',
-            barStyle: 'dark-content',
+            backgroundColor: "#f1f0f8",
+            barStyle: "dark-content",
             translucent: false,
         };
-        if (JSON.stringify(expo.androidStatusBar) !== JSON.stringify(desiredAndroidStatusBar)) {
+        if (JSON.stringify(expo.androidStatusBar) !==
+            JSON.stringify(desiredAndroidStatusBar)) {
             expo.androidStatusBar = desiredAndroidStatusBar;
             changed = true;
         }
-        if (Object.prototype.hasOwnProperty.call(expo, 'androidNavigationBar')) {
+        if (Object.prototype.hasOwnProperty.call(expo, "androidNavigationBar")) {
             delete expo.androidNavigationBar;
             changed = true;
         }
         const desiredNavigationBarPlugin = [
-            'expo-navigation-bar',
+            "expo-navigation-bar",
             {
-                style: 'dark',
+                style: "dark",
                 enforceContrast: false,
             },
         ];
         const plugins = Array.isArray(expo.plugins) ? [...expo.plugins] : [];
         const existingNavigationBarPluginIndex = plugins.findIndex((plugin) => {
-            if (readString(plugin) === 'expo-navigation-bar') {
+            if (readString(plugin) === "expo-navigation-bar") {
                 return true;
             }
-            return Array.isArray(plugin) && readString(plugin[0]) === 'expo-navigation-bar';
+            return (Array.isArray(plugin) && readString(plugin[0]) === "expo-navigation-bar");
         });
         if (existingNavigationBarPluginIndex === -1 ||
             JSON.stringify(plugins[existingNavigationBarPluginIndex]) !==
@@ -1021,13 +1086,13 @@ export async function repairExpoProjectIdentifiers(projectPath, projectName, tar
             changed = true;
         }
         const hasSystemUiPlugin = plugins.some((plugin) => {
-            if (readString(plugin) === 'expo-system-ui') {
+            if (readString(plugin) === "expo-system-ui") {
                 return true;
             }
-            return Array.isArray(plugin) && readString(plugin[0]) === 'expo-system-ui';
+            return (Array.isArray(plugin) && readString(plugin[0]) === "expo-system-ui");
         });
         if (!hasSystemUiPlugin) {
-            plugins.push('expo-system-ui');
+            plugins.push("expo-system-ui");
             changed = true;
         }
         if (JSON.stringify(expo.plugins) !== JSON.stringify(plugins)) {
@@ -1036,34 +1101,35 @@ export async function repairExpoProjectIdentifiers(projectPath, projectName, tar
         }
     }
     else {
-        if (Object.prototype.hasOwnProperty.call(expo, 'androidNavigationBar')) {
+        if (Object.prototype.hasOwnProperty.call(expo, "androidNavigationBar")) {
             delete expo.androidNavigationBar;
             changed = true;
         }
-        if (Object.prototype.hasOwnProperty.call(expo, 'androidStatusBar')) {
+        if (Object.prototype.hasOwnProperty.call(expo, "androidStatusBar")) {
             delete expo.androidStatusBar;
             changed = true;
         }
     }
     if (shouldIncludeAndroid) {
         const deprecatedNavigationBar = {
-            position: 'absolute',
-            backgroundColor: '#00000000',
-            style: 'dark',
+            position: "absolute",
+            backgroundColor: "#00000000",
+            style: "dark",
             enforceContrast: false,
         };
-        if (JSON.stringify(expo.androidNavigationBar) === JSON.stringify(deprecatedNavigationBar)) {
+        if (JSON.stringify(expo.androidNavigationBar) ===
+            JSON.stringify(deprecatedNavigationBar)) {
             delete expo.androidNavigationBar;
         }
     }
     if (!changed) {
         return [];
     }
-    await writeFile(appJsonPath, `${JSON.stringify(parsed, null, 2)}\n`, 'utf8');
+    await writeFile(appJsonPath, `${JSON.stringify(parsed, null, 2)}\n`, "utf8");
     return [appJsonPath];
 }
-export async function repairExpoWebOutputForStylistLifecycle(projectPath, preferredWebOutput = 'static') {
-    const appJsonPath = path.join(projectPath, 'app.json');
+export async function repairExpoWebOutputForStylistLifecycle(projectPath, preferredWebOutput = "static") {
+    const appJsonPath = path.join(projectPath, "app.json");
     const raw = await readOptionalText(appJsonPath);
     if (!raw) {
         return [];
@@ -1081,13 +1147,15 @@ export async function repairExpoWebOutputForStylistLifecycle(projectPath, prefer
         return [];
     }
     const hasWebPlatform = !Array.isArray(expo.platforms) ||
-        expo.platforms.some((platform) => readString(platform) === 'web');
+        expo.platforms.some((platform) => readString(platform) === "web");
     if (!hasWebPlatform) {
         return [];
     }
     const hasStylistSyncRoute = await hasStylistSyncApiRoute(projectPath);
     const preferred = normalizeExpoWebOutput(preferredWebOutput);
-    const desiredOutput = hasStylistSyncRoute ? 'server' : preferred;
+    const desiredOutput = hasStylistSyncRoute
+        ? "server"
+        : preferred;
     const webConfig = isRecord(expo.web) ? expo.web : {};
     const currentOutput = readString(webConfig.output);
     if (currentOutput === desiredOutput) {
@@ -1097,7 +1165,7 @@ export async function repairExpoWebOutputForStylistLifecycle(projectPath, prefer
         ...webConfig,
         output: desiredOutput,
     };
-    await writeFile(appJsonPath, `${JSON.stringify(parsed, null, 2)}\n`, 'utf8');
+    await writeFile(appJsonPath, `${JSON.stringify(parsed, null, 2)}\n`, "utf8");
     return [appJsonPath];
 }
 async function hasStylistSyncApiRoute(projectPath) {
@@ -1110,15 +1178,15 @@ async function hasStylistSyncApiRoute(projectPath) {
 }
 function normalizeExpoWebOutput(value) {
     switch (value) {
-        case 'server':
-            return 'server';
-        case 'spa':
-            return 'single';
-        case 'none':
-            return 'static';
-        case 'static':
+        case "server":
+            return "server";
+        case "spa":
+            return "single";
+        case "none":
+            return "static";
+        case "static":
         default:
-            return 'static';
+            return "static";
     }
 }
 async function findProjectFromCesConfig(cwd, projectName) {
@@ -1129,7 +1197,7 @@ async function findProjectFromCesConfig(cwd, projectName) {
                 continue;
             }
             const projectPath = path.join(cwd, entry.name);
-            const raw = await readOptionalText(path.join(projectPath, 'cesconfig.jsonc'));
+            const raw = await readOptionalText(path.join(projectPath, "cesconfig.jsonc"));
             if (!raw) {
                 continue;
             }
@@ -1145,348 +1213,303 @@ async function findProjectFromCesConfig(cwd, projectName) {
     return null;
 }
 async function detectPackageManager(projectPath, args) {
-    if (args.includes('--pnpm'))
-        return 'pnpm';
-    if (args.includes('--yarn'))
-        return 'yarn';
-    if (args.includes('--bun'))
-        return 'bun';
-    if (args.includes('--npm'))
-        return 'npm';
-    const packageJson = await readJson(path.join(projectPath, 'package.json'));
+    if (args.includes("--pnpm"))
+        return "pnpm";
+    if (args.includes("--yarn"))
+        return "yarn";
+    if (args.includes("--bun"))
+        return "bun";
+    if (args.includes("--npm"))
+        return "npm";
+    const packageJson = await readJson(path.join(projectPath, "package.json"));
     const declared = readString(packageJson.packageManager);
-    if (declared?.startsWith('pnpm@'))
-        return 'pnpm';
-    if (declared?.startsWith('yarn@'))
-        return 'yarn';
-    if (declared?.startsWith('bun@'))
-        return 'bun';
-    if (declared?.startsWith('npm@'))
-        return 'npm';
-    if (await pathExists(path.join(projectPath, 'pnpm-lock.yaml')))
-        return 'pnpm';
-    if (await pathExists(path.join(projectPath, 'yarn.lock')))
-        return 'yarn';
-    if ((await pathExists(path.join(projectPath, 'bun.lock'))) ||
-        (await pathExists(path.join(projectPath, 'bun.lockb')))) {
-        return 'bun';
-    }
-    return 'npm';
+    if (declared?.startsWith("pnpm@"))
+        return "pnpm";
+    if (declared?.startsWith("yarn@"))
+        return "yarn";
+    if (declared?.startsWith("bun@"))
+        return "bun";
+    if (declared?.startsWith("npm@"))
+        return "npm";
+    if (await pathExists(path.join(projectPath, "pnpm-lock.yaml")))
+        return "pnpm";
+    if (await pathExists(path.join(projectPath, "yarn.lock")))
+        return "yarn";
+    if ((await pathExists(path.join(projectPath, "bun.lock"))) ||
+        (await pathExists(path.join(projectPath, "bun.lockb")))) {
+        return "bun";
+    }
+    return "npm";
 }
 function shouldRunExpoProjectChecks(parsed, noInstallRequested) {
-    return !parsed.mds.skipCreate && !parsed.mds.skipExpoFix && !noInstallRequested;
+    return (!parsed.mds.skipCreate && !parsed.mds.skipExpoFix && !noInstallRequested);
 }
 function hasNoInstallFlag(args) {
     return args.some((arg) => {
         const normalized = arg.trim().toLowerCase();
-        return (normalized === '--no-install' ||
-            normalized === '--noinstall' ||
-            normalized === '--no-install=true' ||
-            normalized === '--install=false');
+        return (normalized === "--no-install" ||
+            normalized === "--noinstall" ||
+            normalized === "--no-install=true" ||
+            normalized === "--install=false");
     });
 }
 export function buildInstallCommand(packageManager) {
     switch (packageManager) {
-        case 'pnpm':
+        case "pnpm":
             return {
-                command: 'pnpm',
-                args: ['install', '--config.strict-dep-builds=false', '--ignore-workspace'],
-                display: 'pnpm install --config.strict-dep-builds=false --ignore-workspace',
-                env: { PNPM_CONFIG_STRICT_DEP_BUILDS: 'false' },
+                command: "pnpm",
+                args: [
+                    "install",
+                    "--config.strict-dep-builds=false",
+                    "--ignore-workspace",
+                ],
+                display: "pnpm install --config.strict-dep-builds=false --ignore-workspace",
+                env: { PNPM_CONFIG_STRICT_DEP_BUILDS: "false" },
             };
-        case 'yarn':
+        case "yarn":
             return {
-                command: 'yarn',
-                args: ['install'],
-                display: 'yarn install',
+                command: "yarn",
+                args: ["install"],
+                display: "yarn install",
             };
-        case 'bun':
+        case "bun":
             return {
-                command: 'bun',
-                args: ['install'],
-                display: 'bun install',
+                command: "bun",
+                args: ["install"],
+                display: "bun install",
             };
-        case 'npm':
+        case "npm":
             return {
-                command: 'npm',
-                args: ['install'],
-                display: 'npm install',
+                command: "npm",
+                args: ["install"],
+                display: "npm install",
             };
     }
 }
 export function buildExpoInstallFixCommand(packageManager) {
     switch (packageManager) {
-        case 'pnpm':
+        case "pnpm":
             return {
-                command: 'pnpm',
-                args: ['--ignore-workspace', 'exec', 'expo', 'install', '--fix'],
-                display: 'pnpm --ignore-workspace exec expo install --fix',
-                env: { PNPM_CONFIG_STRICT_DEP_BUILDS: 'false' },
+                command: "pnpm",
+                args: ["--ignore-workspace", "exec", "expo", "install", "--fix"],
+                display: "pnpm --ignore-workspace exec expo install --fix",
+                env: { PNPM_CONFIG_STRICT_DEP_BUILDS: "false" },
             };
-        case 'yarn':
+        case "yarn":
             return {
-                command: 'yarn',
-                args: ['expo', 'install', '--fix'],
-                display: 'yarn expo install --fix',
+                command: "yarn",
+                args: ["expo", "install", "--fix"],
+                display: "yarn expo install --fix",
             };
-        case 'bun':
+        case "bun":
             return {
-                command: 'bunx',
-                args: ['expo', 'install', '--fix'],
-                display: 'bunx expo install --fix',
+                command: "bunx",
+                args: ["expo", "install", "--fix"],
+                display: "bunx expo install --fix",
             };
-        case 'npm':
+        case "npm":
             return {
-                command: 'npx',
-                args: ['expo', 'install', '--fix'],
-                display: 'npx expo install --fix',
+                command: "npx",
+                args: ["expo", "install", "--fix"],
+                display: "npx expo install --fix",
             };
     }
 }
 export function buildExpoLatestSdkCommand(packageManager) {
     switch (packageManager) {
-        case 'pnpm':
+        case "pnpm":
             return {
-                command: 'pnpm',
-                args: ['--ignore-workspace', 'exec', 'expo', 'install', 'expo@latest'],
-                display: 'pnpm --ignore-workspace exec expo install expo@latest',
-                env: { PNPM_CONFIG_STRICT_DEP_BUILDS: 'false' },
+                command: "pnpm",
+                args: ["--ignore-workspace", "exec", "expo", "install", `expo@^${EXPECTED_EXPO_SDK_MAJOR}`],
+                display: `pnpm --ignore-workspace exec expo install expo@^${EXPECTED_EXPO_SDK_MAJOR}`,
+                env: { PNPM_CONFIG_STRICT_DEP_BUILDS: "false" },
             };
-        case 'yarn':
+        case "yarn":
             return {
-                command: 'yarn',
-                args: ['expo', 'install', 'expo@latest'],
-                display: 'yarn expo install expo@latest',
+                command: "yarn",
+                args: ["expo", "install", `expo@^${EXPECTED_EXPO_SDK_MAJOR}`],
+                display: `yarn expo install expo@^${EXPECTED_EXPO_SDK_MAJOR}`,
             };
-        case 'bun':
+        case "bun":
             return {
-                command: 'bunx',
-                args: ['expo', 'install', 'expo@latest'],
-                display: 'bunx expo install expo@latest',
+                command: "bunx",
+                args: ["expo", "install", `expo@^${EXPECTED_EXPO_SDK_MAJOR}`],
+                display: `bunx expo install expo@^${EXPECTED_EXPO_SDK_MAJOR}`,
             };
-        case 'npm':
+        case "npm":
             return {
-                command: 'npx',
-                args: ['expo', 'install', 'expo@latest'],
-                display: 'npx expo install expo@latest',
+                command: "npx",
+                args: ["expo", "install", `expo@^${EXPECTED_EXPO_SDK_MAJOR}`],
+                display: `npx expo install expo@^${EXPECTED_EXPO_SDK_MAJOR}`,
             };
     }
 }
-export function buildExpoPinnedSdkCommand(packageManager) {
-    const target = `expo@${CURRENT_EXPO_SDK_VERSION}`;
-    switch (packageManager) {
-        case 'pnpm':
-            return {
-                command: 'pnpm',
-                args: ['--ignore-workspace', 'exec', 'expo', 'install', target],
-                display: `pnpm --ignore-workspace exec expo install ${target}`,
-                env: { PNPM_CONFIG_STRICT_DEP_BUILDS: 'false' },
-            };
-        case 'yarn':
-            return {
-                command: 'yarn',
-                args: ['expo', 'install', target],
-                display: `yarn expo install ${target}`,
-            };
-        case 'bun':
-            return {
-                command: 'bunx',
-                args: ['expo', 'install', target],
-                display: `bunx expo install ${target}`,
-            };
-        case 'npm':
-            return {
-                command: 'npx',
-                args: ['expo', 'install', target],
-                display: `npx expo install ${target}`,
-            };
-    }
-}
-export async function shouldRunExpoPinnedSdkCommand(projectPath) {
-    const packageJson = await readJson(path.join(projectPath, 'package.json'));
-    return shouldRunExpoPinnedSdkCommandFromPackageJson(packageJson);
-}
-export function shouldRunExpoPinnedSdkCommandFromPackageJson(packageJson) {
-    const dependencies = isRecord(packageJson.dependencies) ? packageJson.dependencies : {};
-    const devDependencies = isRecord(packageJson.devDependencies) ? packageJson.devDependencies : {};
-    const version = readString(dependencies.expo) ?? readString(devDependencies.expo);
-    const current = version ? readSemverTriplet(version) : undefined;
-    const target = readSemverTriplet(CURRENT_EXPO_SDK_VERSION);
-    if (!current || !target) {
-        return false;
-    }
-    if (current.major !== target.major || current.minor !== target.minor) {
-        return false;
-    }
-    return current.patch < target.patch;
-}
 export async function shouldRunExpoLatestSdkCommand(projectPath) {
-    const packageJson = await readJson(path.join(projectPath, 'package.json'));
+    const packageJson = await readJson(path.join(projectPath, "package.json"));
     return shouldRunExpoLatestSdkCommandFromPackageJson(packageJson);
 }
 export function shouldRunExpoLatestSdkCommandFromPackageJson(packageJson) {
-    const dependencies = isRecord(packageJson.dependencies) ? packageJson.dependencies : {};
-    const devDependencies = isRecord(packageJson.devDependencies) ? packageJson.devDependencies : {};
+    const dependencies = isRecord(packageJson.dependencies)
+        ? packageJson.dependencies
+        : {};
+    const devDependencies = isRecord(packageJson.devDependencies)
+        ? packageJson.devDependencies
+        : {};
     const version = readString(dependencies.expo) ?? readString(devDependencies.expo);
-    if (!version || version === 'latest') {
-        return !version;
-    }
-    const major = readSemverMajor(version);
-    return major === undefined || major < CURRENT_EXPO_SDK_MAJOR;
-}
-function readSemverMajor(version) {
-    const match = version.match(/\d+/u);
-    if (!match) {
-        return undefined;
-    }
-    return Number.parseInt(match[0], 10);
+    return parseExpoSdkMajor(version) !== EXPECTED_EXPO_SDK_MAJOR;
 }
-function readSemverTriplet(version) {
-    const match = version.match(/(\d+)\.(\d+)\.(\d+)/u);
-    if (!match) {
-        return undefined;
+export function parseExpoSdkMajor(version) {
+    if (!version) {
+        return null;
     }
-    const major = match[1];
-    const minor = match[2];
-    const patch = match[3];
-    if (!major || !minor || !patch) {
-        return undefined;
+    const match = /(\d+)/u.exec(version);
+    return match ? Number.parseInt(match[1] ?? "", 10) : null;
+}
+export async function assertExpectedExpoSdk(projectPath) {
+    const packageJson = await readJson(path.join(projectPath, "package.json"));
+    const dependencies = isRecord(packageJson.dependencies)
+        ? packageJson.dependencies
+        : {};
+    const devDependencies = isRecord(packageJson.devDependencies)
+        ? packageJson.devDependencies
+        : {};
+    const version = readString(dependencies.expo) ?? readString(devDependencies.expo);
+    const resolvedMajor = parseExpoSdkMajor(version);
+    if (resolvedMajor !== EXPECTED_EXPO_SDK_MAJOR) {
+        throw new Error(`Generated project did not resolve to Expo SDK ${EXPECTED_EXPO_SDK_MAJOR}. Found expo dependency ${version ?? "missing"} in package.json.`);
     }
-    return {
-        major: Number.parseInt(major, 10),
-        minor: Number.parseInt(minor, 10),
-        patch: Number.parseInt(patch, 10),
-    };
 }
 export function buildExpoFontInstallCommand(packageManager) {
     switch (packageManager) {
-        case 'pnpm':
+        case "pnpm":
             return {
-                command: 'pnpm',
-                args: ['--ignore-workspace', 'exec', 'expo', 'install', 'expo-font'],
-                display: 'pnpm --ignore-workspace exec expo install expo-font',
-                env: { PNPM_CONFIG_STRICT_DEP_BUILDS: 'false' },
+                command: "pnpm",
+                args: ["--ignore-workspace", "exec", "expo", "install", "expo-font"],
+                display: "pnpm --ignore-workspace exec expo install expo-font",
+                env: { PNPM_CONFIG_STRICT_DEP_BUILDS: "false" },
             };
-        case 'yarn':
+        case "yarn":
             return {
-                command: 'yarn',
-                args: ['expo', 'install', 'expo-font'],
-                display: 'yarn expo install expo-font',
+                command: "yarn",
+                args: ["expo", "install", "expo-font"],
+                display: "yarn expo install expo-font",
             };
-        case 'bun':
+        case "bun":
             return {
-                command: 'bunx',
-                args: ['expo', 'install', 'expo-font'],
-                display: 'bunx expo install expo-font',
+                command: "bunx",
+                args: ["expo", "install", "expo-font"],
+                display: "bunx expo install expo-font",
             };
-        case 'npm':
+        case "npm":
             return {
-                command: 'npx',
-                args: ['expo', 'install', 'expo-font'],
-                display: 'npx expo install expo-font',
+                command: "npx",
+                args: ["expo", "install", "expo-font"],
+                display: "npx expo install expo-font",
             };
     }
 }
 export function buildExpoDoctorCommand(packageManager) {
     switch (packageManager) {
-        case 'pnpm':
+        case "pnpm":
             return {
-                command: 'pnpm',
-                args: ['--ignore-workspace', 'dlx', 'expo-doctor'],
-                display: 'pnpm --ignore-workspace dlx expo-doctor',
+                command: "pnpm",
+                args: ["--ignore-workspace", "dlx", "expo-doctor"],
+                display: "pnpm --ignore-workspace dlx expo-doctor",
             };
-        case 'yarn':
+        case "yarn":
             return {
-                command: 'yarn',
-                args: ['dlx', 'expo-doctor'],
-                display: 'yarn dlx expo-doctor',
+                command: "yarn",
+                args: ["dlx", "expo-doctor"],
+                display: "yarn dlx expo-doctor",
             };
-        case 'bun':
+        case "bun":
             return {
-                command: 'bunx',
-                args: ['expo-doctor'],
-                display: 'bunx expo-doctor',
+                command: "bunx",
+                args: ["expo-doctor"],
+                display: "bunx expo-doctor",
             };
-        case 'npm':
+        case "npm":
             return {
-                command: 'npx',
-                args: ['expo-doctor'],
-                display: 'npx expo-doctor',
+                command: "npx",
+                args: ["expo-doctor"],
+                display: "npx expo-doctor",
             };
     }
 }
 export function buildPrettierWriteCommand(packageManager) {
-    const glob = '**/*.{js,jsx,ts,tsx,json}';
+    const glob = "**/*.{js,jsx,ts,tsx,json}";
     switch (packageManager) {
-        case 'pnpm':
+        case "pnpm":
             return {
-                command: 'pnpm',
-                args: ['exec', 'prettier', '--write', glob],
+                command: "pnpm",
+                args: ["exec", "prettier", "--write", glob],
                 display: `pnpm exec prettier --write "${glob}"`,
             };
-        case 'yarn':
+        case "yarn":
             return {
-                command: 'yarn',
-                args: ['prettier', '--write', glob],
+                command: "yarn",
+                args: ["prettier", "--write", glob],
                 display: `yarn prettier --write "${glob}"`,
             };
-        case 'bun':
+        case "bun":
             return {
-                command: 'bunx',
-                args: ['prettier', '--write', glob],
+                command: "bunx",
+                args: ["prettier", "--write", glob],
                 display: `bunx prettier --write "${glob}"`,
             };
-        case 'npm':
+        case "npm":
         default:
             return {
-                command: 'npx',
-                args: ['prettier', '--write', glob],
+                command: "npx",
+                args: ["prettier", "--write", glob],
                 display: `npx prettier --write "${glob}"`,
             };
     }
 }
 export function buildAddDevDependencyCommand(packageManager, dependency) {
     switch (packageManager) {
-        case 'pnpm':
+        case "pnpm":
             return {
-                command: 'pnpm',
-                args: ['--ignore-workspace', 'add', '-D', dependency],
+                command: "pnpm",
+                args: ["--ignore-workspace", "add", "-D", dependency],
                 display: `pnpm --ignore-workspace add -D ${dependency}`,
-                env: { PNPM_CONFIG_STRICT_DEP_BUILDS: 'false' },
+                env: { PNPM_CONFIG_STRICT_DEP_BUILDS: "false" },
             };
-        case 'yarn':
+        case "yarn":
             return {
-                command: 'yarn',
-                args: ['add', '--dev', dependency],
+                command: "yarn",
+                args: ["add", "--dev", dependency],
                 display: `yarn add --dev ${dependency}`,
             };
-        case 'bun':
+        case "bun":
             return {
-                command: 'bun',
-                args: ['add', '--dev', dependency],
+                command: "bun",
+                args: ["add", "--dev", dependency],
                 display: `bun add --dev ${dependency}`,
             };
-        case 'npm':
+        case "npm":
             return {
-                command: 'npm',
-                args: ['install', '--save-dev', dependency],
+                command: "npm",
+                args: ["install", "--save-dev", dependency],
                 display: `npm install --save-dev ${dependency}`,
             };
     }
 }
 export function resolveWindowsTailwindOxidePackage({ platform = process.platform, arch = process.arch, nodeTargetType = process.config?.variables?.node_target_type, shlibSuffix = process.config?.variables?.shlib_suffix, } = {}) {
-    if (platform !== 'win32') {
+    if (platform !== "win32") {
         return undefined;
     }
-    if (arch === 'x64') {
-        const usesGnu = shlibSuffix === 'dll.a' || nodeTargetType === 'shared_library';
-        return usesGnu ? '@tailwindcss/oxide-win32-x64-gnu' : '@tailwindcss/oxide-win32-x64-msvc';
+    if (arch === "x64") {
+        const usesGnu = shlibSuffix === "dll.a" || nodeTargetType === "shared_library";
+        return usesGnu
+            ? "@tailwindcss/oxide-win32-x64-gnu"
+            : "@tailwindcss/oxide-win32-x64-msvc";
     }
-    if (arch === 'ia32') {
-        return '@tailwindcss/oxide-win32-ia32-msvc';
+    if (arch === "ia32") {
+        return "@tailwindcss/oxide-win32-ia32-msvc";
     }
-    if (arch === 'arm64') {
-        return '@tailwindcss/oxide-win32-arm64-msvc';
+    if (arch === "arm64") {
+        return "@tailwindcss/oxide-win32-arm64-msvc";
     }
     return undefined;
 }
@@ -1495,46 +1518,55 @@ export async function resolveMissingWindowsTailwindOxideBinding(projectPath) {
     if (!packageName) {
         return undefined;
     }
-    const packageJson = await readJson(path.join(projectPath, 'package.json'));
-    const dependencies = isRecord(packageJson.dependencies) ? packageJson.dependencies : {};
-    const devDependencies = isRecord(packageJson.devDependencies) ? packageJson.devDependencies : {};
-    const hasUniwind = typeof dependencies.uniwind === 'string' || typeof devDependencies.uniwind === 'string';
+    const packageJson = await readJson(path.join(projectPath, "package.json"));
+    const dependencies = isRecord(packageJson.dependencies)
+        ? packageJson.dependencies
+        : {};
+    const devDependencies = isRecord(packageJson.devDependencies)
+        ? packageJson.devDependencies
+        : {};
+    const hasUniwind = typeof dependencies.uniwind === "string" ||
+        typeof devDependencies.uniwind === "string";
     if (!hasUniwind) {
         return undefined;
     }
-    if (await pathExists(path.join(projectPath, 'node_modules', packageName))) {
+    if (await pathExists(path.join(projectPath, "node_modules", packageName))) {
         return undefined;
     }
-    const oxidePackageJsonPath = path.join(projectPath, 'node_modules', '@tailwindcss', 'oxide', 'package.json');
+    const oxidePackageJsonPath = path.join(projectPath, "node_modules", "@tailwindcss", "oxide", "package.json");
     const oxidePackage = await readJson(oxidePackageJsonPath);
     const oxideVersion = readString(oxidePackage.version);
     return oxideVersion ? `${packageName}@${oxideVersion}` : packageName;
 }
 export async function shouldInstallExpoFontPeer(projectPath) {
-    const packageJson = await readJson(path.join(projectPath, 'package.json'));
+    const packageJson = await readJson(path.join(projectPath, "package.json"));
     return shouldInstallExpoFontPeerFromPackageJson(packageJson);
 }
 export function shouldInstallExpoFontPeerFromPackageJson(packageJson) {
-    const dependencies = isRecord(packageJson.dependencies) ? packageJson.dependencies : {};
-    const devDependencies = isRecord(packageJson.devDependencies) ? packageJson.devDependencies : {};
-    const hasVectorIcons = typeof dependencies['@expo/vector-icons'] === 'string' ||
-        typeof devDependencies['@expo/vector-icons'] === 'string';
-    const hasExpoFont = typeof dependencies['expo-font'] === 'string' ||
-        typeof devDependencies['expo-font'] === 'string';
+    const dependencies = isRecord(packageJson.dependencies)
+        ? packageJson.dependencies
+        : {};
+    const devDependencies = isRecord(packageJson.devDependencies)
+        ? packageJson.devDependencies
+        : {};
+    const hasVectorIcons = typeof dependencies["@expo/vector-icons"] === "string" ||
+        typeof devDependencies["@expo/vector-icons"] === "string";
+    const hasExpoFont = typeof dependencies["expo-font"] === "string" ||
+        typeof devDependencies["expo-font"] === "string";
     return hasVectorIcons && !hasExpoFont;
 }
 export async function detectEasSetup(projectPath, createExpoStackArgs) {
-    if (hasFlag(createExpoStackArgs, '--eas')) {
+    if (hasFlag(createExpoStackArgs, "--eas")) {
         return true;
     }
-    if (await pathExists(path.join(projectPath, 'eas.json'))) {
+    if (await pathExists(path.join(projectPath, "eas.json"))) {
         return true;
     }
-    const appJson = await readJson(path.join(projectPath, 'app.json'));
+    const appJson = await readJson(path.join(projectPath, "app.json"));
     if (hasExpoEasProjectId(appJson)) {
         return true;
     }
-    const appConfigJson = await readJson(path.join(projectPath, 'app.config.json'));
+    const appConfigJson = await readJson(path.join(projectPath, "app.config.json"));
     if (hasExpoEasProjectId(appConfigJson)) {
         return true;
     }
@@ -1547,22 +1579,22 @@ function hasExpoEasProjectId(config) {
     const expo = isRecord(config.expo) ? config.expo : config;
     const extra = isRecord(expo.extra) ? expo.extra : undefined;
     const eas = extra && isRecord(extra.eas) ? extra.eas : undefined;
-    return typeof eas?.projectId === 'string' && eas.projectId.trim().length > 0;
+    return typeof eas?.projectId === "string" && eas.projectId.trim().length > 0;
 }
 function buildRunScriptCommand(packageManager, script) {
     switch (packageManager) {
-        case 'pnpm':
+        case "pnpm":
             return `pnpm ${script}`;
-        case 'yarn':
+        case "yarn":
             return `yarn ${script}`;
-        case 'bun':
+        case "bun":
             return `bun run ${script}`;
-        case 'npm':
+        case "npm":
             return `npm run ${script}`;
     }
 }
 function formatDisplayArgs(args) {
-    return args.map(quoteDisplayArg).join(' ');
+    return args.map(quoteDisplayArg).join(" ");
 }
 function quoteDisplayArg(value) {
     if (!value || /[\s"]/u.test(value)) {
@@ -1570,7 +1602,29 @@ function quoteDisplayArg(value) {
     }
     return value;
 }
+function printCopyableCommands(title, commands) {
+    console.log(`${title} (copy this):`);
+    console.log(renderCommandBox(commands));
+}
+function renderCommandBox(commands) {
+    const visibleCommands = commands.filter((command) => command.trim().length > 0);
+    if (visibleCommands.length === 0) {
+        return "";
+    }
+    const formattedCommands = visibleCommands.map((command) => colorizeCommand(`> ${command}`));
+    return ["┌", ...formattedCommands.map((command) => `│ ${command}`), "└"].join("\n");
+}
+function colorizeCommand(command) {
+    if (!supportsAnsiColor()) {
+        return command;
+    }
+    return `\x1b[36m${command}\x1b[0m`;
+}
+function supportsAnsiColor() {
+    return process.stdout.isTTY === true && process.env.TERM !== "dumb";
+}
 function buildOnboardArgv(projectPath, parsed, easSelected) {
+    const generatorChoices = inferGeneratorChoices(parsed.createExpoStackArgs, easSelected);
     return {
         project: projectPath,
         yes: parsed.mds.yes,
@@ -1580,6 +1634,14 @@ function buildOnboardArgv(projectPath, parsed, easSelected) {
         guidelinesTemplatePath: parsed.mds.guidelinesTemplatePath,
         easSelected,
         appName: parsed.mds.appName,
+        generatorScriptLanguage: generatorChoices.scriptLanguage,
+        generatorPackageManager: generatorChoices.packageManager,
+        generatorNavigationLibrary: generatorChoices.navigationLibrary,
+        generatorReactNavigationLayout: generatorChoices.reactNavigationLayout,
+        generatorStylingSystem: generatorChoices.stylingSystem,
+        generatorStateManagement: generatorChoices.stateManagement,
+        generatorAuthBackend: generatorChoices.authBackend,
+        generatorEasSetup: generatorChoices.easSetup,
         audience: parsed.mds.audience,
         coreFlows: parsed.mds.coreFlows,
         screens: parsed.mds.screens,
@@ -1592,21 +1654,55 @@ function buildOnboardArgv(projectPath, parsed, easSelected) {
         platforms: parsed.mds.platforms,
         firstPlatform: parsed.mds.firstPlatform,
         platformStrategy: parsed.mds.platformStrategy,
-        appDirectory: parsed.mds.appDirectory ?? 'src',
+        appDirectory: parsed.mds.appDirectory ?? "src",
         platformLayouts: parsed.mds.platformLayouts,
         webOutput: parsed.mds.webOutput,
         deployedServer: parsed.mds.deployedServer,
         createExpoComponents: parsed.mds.createExpoComponents,
-        latestExpoSdk: parsed.mds.latestExpoSdk,
         expoUi: parsed.mds.expoUi,
         expoUiUniversal: parsed.mds.expoUiUniversal,
         expoNativeTabs: parsed.mds.expoNativeTabs,
         easUses: parsed.mds.easUses,
     };
 }
+function inferGeneratorChoices(args, easSelected) {
+    const hasFlag = (flag) => args.includes(flag);
+    return {
+        scriptLanguage: hasFlag("--javascript") ? "javascript" : "typescript",
+        packageManager: hasFlag("--pnpm")
+            ? "pnpm"
+            : hasFlag("--yarn")
+                ? "yarn"
+                : hasFlag("--bun")
+                    ? "bun"
+                    : "npm",
+        navigationLibrary: hasFlag("--react-navigation") ? "react-navigation" : "expo-router",
+        reactNavigationLayout: hasFlag("--tabs")
+            ? "tabs"
+            : hasFlag("--drawer+tabs")
+                ? "drawer"
+                : "stack",
+        stylingSystem: hasFlag("--nativewind")
+            ? "nativewind"
+            : hasFlag("--tamagui")
+                ? "tamagui"
+                : hasFlag("--restyle")
+                    ? "restyle"
+                    : hasFlag("--uniwind")
+                        ? "uniwind"
+                        : "stylesheet",
+        stateManagement: hasFlag("--zustand") ? "zustand" : "none",
+        authBackend: hasFlag("--supabase")
+            ? "supabase"
+            : hasFlag("--firebase")
+                ? "firebase"
+                : "none",
+        easSetup: easSelected,
+    };
+}
 function splitList(value) {
     return value
-        .split(',')
+        .split(",")
         .map((item) => item.trim())
         .filter(Boolean);
 }
@@ -1621,7 +1717,7 @@ async function pathExists(filePath) {
 }
 async function readOptionalText(filePath) {
     try {
-        return await readFile(filePath, 'utf8');
+        return await readFile(filePath, "utf8");
     }
     catch {
         return null;
@@ -1641,32 +1737,32 @@ async function readJson(filePath) {
     }
 }
 function parseJsonc(value) {
-    const cleaned = value.replace(/^\s*\/\/.*$/gm, '');
+    const cleaned = value.replace(/^\s*\/\/.*$/gm, "");
     const parsed = JSON.parse(cleaned);
     return isRecord(parsed) ? parsed : {};
 }
 function readString(value) {
-    return typeof value === 'string' ? value : undefined;
+    return typeof value === "string" ? value : undefined;
 }
 export function toExpoSlug(value) {
     const slug = value
         .trim()
         .toLowerCase()
-        .replace(/[^a-z0-9_-]+/g, '-')
-        .replace(/^-+|-+$/g, '');
-    return slug || 'expo-app';
+        .replace(/[^a-z0-9_-]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    return slug || "expo-app";
 }
 export function toExpoScheme(value) {
     const scheme = value
         .trim()
         .toLowerCase()
-        .replace(/[^a-z0-9+.-]+/g, '-')
-        .replace(/^[^a-z]+/, '')
-        .replace(/-+$/g, '');
-    return scheme || 'expo-app';
+        .replace(/[^a-z0-9+.-]+/g, "-")
+        .replace(/^[^a-z]+/, "")
+        .replace(/-+$/g, "");
+    return scheme || "expo-app";
 }
 function isRecord(value) {
-    return typeof value === 'object' && value !== null && !Array.isArray(value);
+    return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 export function isCliEntryPoint(argv = process.argv) {
     const entry = argv[1];