feat: create-start-app creates start applications only

jherr · jherr · commit f44ca9b52c03 · 2025-03-29T15:53:52.000-07:00
diff --git a/cli/create-start-app/src/index.ts b/cli/create-start-app/src/index.ts
@@ -1,4 +1,8 @@
 #!/usr/bin/env node
 import { cli } from '@tanstack/cta-engine'
 
-cli()
+cli({
+  name: 'create-start-app',
+  forcedMode: 'file-router',
+  forcedAddOns: ['start'],
+})
diff --git a/cli/create-tsrouter-app/src/index.ts b/cli/create-tsrouter-app/src/index.ts
@@ -1,4 +1,6 @@
 #!/usr/bin/env node
 import { cli } from '@tanstack/cta-engine'
 
-cli()
+cli({
+  name: 'create-tsrouter-app',
+})
diff --git a/packages/cta-engine/src/add.ts b/packages/cta-engine/src/add.ts
@@ -25,7 +25,7 @@ import { readConfigFile, writeConfigFile } from './config-file.js'
 
 import type { PersistedOptions } from './config-file.js'
 
-import type { Options } from './types.js'
+import type { Framework, Options } from './types.js'
 
 function isDirectory(path: string) {
   return statSync(path).isDirectory()
@@ -43,10 +43,11 @@ async function createOptions(
   return {
     ...json,
     tailwind: true,
-    chosenAddOns: await finalizeAddOns(json.framework!, json.mode!, [
-      ...json.existingAddOns,
-      ...addOns,
-    ]),
+    chosenAddOns: await finalizeAddOns(
+      json.framework as Framework,
+      json.mode as string,
+      [...json.existingAddOns, ...addOns],
+    ),
   } as Required<Options>
 }
 
@@ -56,6 +57,7 @@ async function runCreateApp(options: Required<Options>) {
     silent: true,
     environment,
     cwd: process.cwd(),
+    name: 'create-tsrouter-app',
   })
   return output
 }
diff --git a/packages/cta-engine/src/cli.ts b/packages/cta-engine/src/cli.ts
@@ -18,7 +18,15 @@ import type { PackageManager } from './package-manager.js'
 import type { ToolChain } from './toolchain.js'
 import type { CliOptions, Framework } from './types.js'
 
-export function cli() {
+export function cli({
+  name,
+  forcedMode,
+  forcedAddOns,
+}: {
+  name: string
+  forcedMode?: 'typescript' | 'javascript' | 'file-router'
+  forcedAddOns?: Array<string>
+}) {
   const program = new Command()
 
   program
@@ -46,7 +54,7 @@ export function cli() {
   //     await initAddOn('overlay')
   //   })
 
-  program // 104 22
+  program
     .argument('[project-name]', 'name of the project')
     .option('--no-git', 'do not create a git repository')
     .option('--target-dir <path>', 'the directory to create the project in')
@@ -65,22 +73,6 @@ export function cli() {
       },
       DEFAULT_FRAMEWORK,
     )
-    .option<'typescript' | 'javascript' | 'file-router'>(
-      '--template <type>',
-      'project template (typescript, javascript, file-router)',
-      (value) => {
-        if (
-          value !== 'typescript' &&
-          value !== 'javascript' &&
-          value !== 'file-router'
-        ) {
-          throw new InvalidArgumentError(
-            `Invalid template: ${value}. Only the following are allowed: typescript, javascript, file-router`,
-          )
-        }
-        return value
-      },
-    )
     .option<PackageManager>(
       `--package-manager <${SUPPORTED_PACKAGE_MANAGERS.join('|')}>`,
       `Explicitly tell the CLI to use this package manager`,
@@ -122,42 +114,68 @@ export function cli() {
       },
     )
     .option('--list-add-ons', 'list all available add-ons', false)
-    .option('--overlay [url]', 'add an overlay from a URL', false)
+    // .option('--overlay [url]', 'add an overlay from a URL', false)
     .option('--mcp', 'run the MCP server', false)
     .option('--mcp-sse', 'run the MCP server in SSE mode', false)
-    .action(async (projectName: string, options: CliOptions) => {
-      if (options.listAddOns) {
-        await listAddOns(options)
-      } else if (options.mcp || options.mcpSse) {
-        await runServer(!!options.mcpSse)
-      } else {
-        try {
-          const cliOptions = {
-            projectName,
-            ...options,
-          } as CliOptions
 
-          let finalOptions = await normalizeOptions(cliOptions)
-          if (finalOptions) {
-            intro(`Creating a new TanStack app in ${projectName}...`)
-          } else {
-            intro("Let's configure your TanStack application")
-            finalOptions = await promptForOptions(cliOptions)
-          }
-          await createApp(finalOptions, {
-            environment: createDefaultEnvironment(),
-            cwd: options.targetDir || undefined,
-          })
-        } catch (error) {
-          log.error(
-            error instanceof Error
-              ? error.message
-              : 'An unknown error occurred',
+  if (!forcedMode) {
+    program.option<'typescript' | 'javascript' | 'file-router'>(
+      '--template <type>',
+      'project template (typescript, javascript, file-router)',
+      (value) => {
+        if (
+          value !== 'typescript' &&
+          value !== 'javascript' &&
+          value !== 'file-router'
+        ) {
+          throw new InvalidArgumentError(
+            `Invalid template: ${value}. Only the following are allowed: typescript, javascript, file-router`,
           )
-          process.exit(1)
         }
+        return value
+      },
+    )
+  }
+
+  program.action(async (projectName: string, options: CliOptions) => {
+    if (options.listAddOns) {
+      await listAddOns(options)
+    } else if (options.mcp || options.mcpSse) {
+      await runServer(!!options.mcpSse)
+    } else {
+      try {
+        const cliOptions = {
+          projectName,
+          ...options,
+        } as CliOptions
+
+        if (forcedMode) {
+          cliOptions.template = forcedMode
+        }
+
+        let finalOptions = await normalizeOptions(cliOptions, forcedAddOns)
+        if (finalOptions) {
+          intro(`Creating a new TanStack app in ${projectName}...`)
+        } else {
+          intro("Let's configure your TanStack application")
+          finalOptions = await promptForOptions(cliOptions, {
+            forcedMode,
+            forcedAddOns,
+          })
+        }
+        await createApp(finalOptions, {
+          environment: createDefaultEnvironment(),
+          cwd: options.targetDir || undefined,
+          name,
+        })
+      } catch (error) {
+        log.error(
+          error instanceof Error ? error.message : 'An unknown error occurred',
+        )
+        process.exit(1)
       }
-    })
+    }
+  })
 
   program.parse()
 }
diff --git a/packages/cta-engine/src/create-app.ts b/packages/cta-engine/src/create-app.ts
@@ -304,10 +304,12 @@ export async function createApp(
     silent = false,
     environment,
     cwd,
+    name = 'create-tsrouter-app',
   }: {
     silent?: boolean
     environment: Environment
     cwd?: string
+    name: string
   },
 ) {
   environment.startRun()
diff --git a/packages/cta-engine/src/custom-add-on.ts b/packages/cta-engine/src/custom-add-on.ts
@@ -8,7 +8,7 @@ import { createApp } from './create-app.js'
 import { readConfigFile } from './config-file.js'
 import { finalizeAddOns } from './add-ons.js'
 
-import type { Options } from './types.js'
+import type { Framework, Options } from './types.js'
 import type { PersistedOptions } from './config-file.js'
 
 type AddOnMode = 'add-on' | 'overlay'
@@ -106,9 +106,11 @@ async function createOptions(
 ): Promise<Required<Options>> {
   return {
     ...json,
-    chosenAddOns: await finalizeAddOns(json.framework!, json.mode!, [
-      ...json.existingAddOns,
-    ]),
+    chosenAddOns: await finalizeAddOns(
+      json.framework as Framework,
+      json.mode as string,
+      [...json.existingAddOns],
+    ),
   } as Required<Options>
 }
 
@@ -118,6 +120,7 @@ async function runCreateApp(options: Required<Options>) {
     silent: true,
     environment,
     cwd: process.cwd(),
+    name: 'create-tsrouter-app',
   })
   return output
 }
diff --git a/packages/cta-engine/src/mcp.ts b/packages/cta-engine/src/mcp.ts
@@ -114,6 +114,7 @@ server.tool(
         {
           silent: true,
           environment: createDefaultEnvironment(),
+          name: 'create-tsrouter-app',
         },
       )
       return {
@@ -209,6 +210,7 @@ server.tool(
         {
           silent: true,
           environment: createDefaultEnvironment(),
+          name: 'create-tsrouter-app',
         },
       )
       return {
diff --git a/packages/cta-engine/src/options.ts b/packages/cta-engine/src/options.ts
@@ -21,6 +21,7 @@ import type { AddOn, CliOptions, Options, Overlay, Variable } from './types.js'
 // If all CLI options are provided, use them directly
 export async function normalizeOptions(
   cliOptions: CliOptions,
+  forcedAddOns?: Array<string>,
 ): Promise<Options | undefined> {
   // in some cases, if you use windows/powershell, the argument for addons
   // if sepparated by comma is not really passed as an array, but as a string
@@ -30,6 +31,9 @@ export async function normalizeOptions(
     if (parseSeparatedArgs.length > 1) {
       cliOptions.addOns = parseSeparatedArgs
     }
+    if (forcedAddOns) {
+      cliOptions.addOns = [...cliOptions.addOns, ...forcedAddOns]
+    }
   }
   if (cliOptions.projectName) {
     let typescript =
@@ -135,6 +139,13 @@ async function collectVariables(
 
 export async function promptForOptions(
   cliOptions: CliOptions,
+  {
+    forcedAddOns = [],
+    forcedMode,
+  }: {
+    forcedAddOns?: Array<string>
+    forcedMode?: 'typescript' | 'javascript' | 'file-router'
+  },
 ): Promise<Required<Options>> {
   const options = {} as Required<Options>
 
@@ -166,7 +177,7 @@ export async function promptForOptions(
   }
 
   // Router type selection
-  if (!cliOptions.template) {
+  if (!cliOptions.template && !forcedMode) {
     const routerType = await select({
       message: 'Select the router type:',
       options: [
@@ -186,6 +197,9 @@ export async function promptForOptions(
       process.exit(0)
     }
     options.mode = routerType as typeof CODE_ROUTER | typeof FILE_ROUTER
+  } else if (forcedMode) {
+    options.mode = forcedMode === 'file-router' ? FILE_ROUTER : CODE_ROUTER
+    options.typescript = options.mode === FILE_ROUTER
   } else {
     options.mode =
       cliOptions.template === 'file-router' ? FILE_ROUTER : CODE_ROUTER
@@ -274,7 +288,7 @@ export async function promptForOptions(
     options.chosenAddOns = await finalizeAddOns(
       options.framework,
       options.mode,
-      cliOptions.addOns,
+      Array.from(new Set([...cliOptions.addOns, ...forcedAddOns])),
     )
     options.tailwind = true
   } else if (cliOptions.addOns) {
@@ -285,11 +299,13 @@ export async function promptForOptions(
     if (options.typescript && addOns.length > 0) {
       const value = await multiselect({
         message: 'What add-ons would you like for your project:',
-        options: addOns.map((addOn) => ({
-          value: addOn.id,
-          label: addOn.name,
-          hint: addOn.description,
-        })),
+        options: addOns
+          .filter((addOn) => !forcedAddOns.includes(addOn.id))
+          .map((addOn) => ({
+            value: addOn.id,
+            label: addOn.name,
+            hint: addOn.description,
+          })),
         required: false,
       })
 
@@ -306,11 +322,13 @@ export async function promptForOptions(
     if (options.typescript && examples.length > 0) {
       const value = await multiselect({
         message: 'Would you like any examples?',
-        options: examples.map((addOn) => ({
-          value: addOn.id,
-          label: addOn.name,
-          hint: addOn.description,
-        })),
+        options: examples
+          .filter((addOn) => !forcedAddOns.includes(addOn.id))
+          .map((addOn) => ({
+            value: addOn.id,
+            label: addOn.name,
+            hint: addOn.description,
+          })),
         required: false,
       })
 
@@ -321,14 +339,26 @@ export async function promptForOptions(
       selectedExamples = value
     }
 
-    if (selectedAddOns.length > 0 || selectedExamples.length > 0) {
+    if (
+      selectedAddOns.length > 0 ||
+      selectedExamples.length > 0 ||
+      forcedAddOns.length > 0
+    ) {
       options.chosenAddOns = await finalizeAddOns(
         options.framework,
         options.mode,
-        [...selectedAddOns, ...selectedExamples],
+        Array.from(
+          new Set([...selectedAddOns, ...selectedExamples, ...forcedAddOns]),
+        ),
       )
       options.tailwind = true
     }
+  } else if (forcedAddOns.length > 0) {
+    options.chosenAddOns = await finalizeAddOns(
+      options.framework,
+      options.mode,
+      forcedAddOns,
+    )
   }
 
   // Collect variables

Original file line number	Diff line number	Diff line change
`@@ -114,6 +114,7 @@ server.tool(`
`114`	`114`	`{`
`115`	`115`	`silent: true,`
`116`	`116`	`environment: createDefaultEnvironment(),`
	`117`	`+ name: 'create-tsrouter-app',`
`117`	`118`	`},`
`118`	`119`	`)`
`119`	`120`	`return {`
`@@ -209,6 +210,7 @@ server.tool(`
`209`	`210`	`{`
`210`	`211`	`silent: true,`
`211`	`212`	`environment: createDefaultEnvironment(),`
	`213`	`+ name: 'create-tsrouter-app',`
`212`	`214`	`},`
`213`	`215`	`)`
`214`	`216`	`return {`