@tanstack/cli 0.48.7 → 0.59.0

package/src/cli.ts

@@ -24,13 +24,16 @@ import { launchUI } from '@tanstack/create-ui'
 import { runMCPServer } from './mcp.js'
 
 import { promptForAddOns, promptForCreateOptions } from './options.js'
-import { normalizeOptions, validateDevWatchOptions } from './command-line.js'
+import {
+  normalizeOptions,
+  validateDevWatchOptions,
+  validateLegacyCreateFlags,
+} from './command-line.js'
 
 import { createUIEnvironment } from './ui-environment.js'
-import { convertTemplateToMode } from './utils.js'
 import { DevWatchManager } from './dev-watch.js'
 
-import type { CliOptions, TemplateOptions } from './types.js'
+import type { CliOptions } from './types.js'
 import type {
   FrameworkDefinition,
   Options,
@@ -45,12 +48,9 @@ const VERSION = packageJson.version
 export function cli({
   name,
   appName,
-  forcedMode,
   forcedAddOns = [],
-  defaultTemplate = 'javascript',
   forcedDeployment,
   defaultFramework,
-  craCompatible = false,
   webBase,
   frameworkDefinitionInitializers,
   showDeploymentOptions = false,
@@ -58,12 +58,9 @@ export function cli({
 }: {
   name: string
   appName: string
-  forcedMode?: string
   forcedAddOns?: Array<string>
   forcedDeployment?: string
-  defaultTemplate?: TemplateOptions
   defaultFramework?: string
-  craCompatible?: boolean
   webBase?: string
   frameworkDefinitionInitializers?: Array<() => FrameworkDefinition>
   showDeploymentOptions?: boolean
@@ -93,23 +90,8 @@ export function cli({
     }
   }
 
-  let defaultMode: string | undefined = forcedMode
-  const supportedModes = new Set<string>()
-  for (const framework of getFrameworks()) {
-    for (const mode of Object.keys(framework.supportedModes)) {
-      supportedModes.add(mode)
-    }
-  }
-  if (defaultMode && !supportedModes.has(defaultMode)) {
-    throw new InvalidArgumentError(
-      `Invalid mode: ${defaultMode}. The following are allowed: ${Array.from(
-        supportedModes,
-      ).join(', ')}`,
-    )
-  }
-  if (supportedModes.size < 2) {
-    defaultMode = Array.from(supportedModes)[0]
-  }
+  // Mode is always file-router (TanStack Start)
+  const defaultMode = 'file-router'
 
   program
     .name(name)
@@ -118,11 +100,20 @@ export function cli({
 
   // Helper to create the create command action handler
   async function handleCreate(projectName: string, options: CliOptions) {
+    const legacyCreateFlags = validateLegacyCreateFlags(options)
+    if (legacyCreateFlags.error) {
+      log.error(legacyCreateFlags.error)
+      process.exit(1)
+    }
+
+    for (const warning of legacyCreateFlags.warnings) {
+      log.warn(warning)
+    }
+
     if (options.listAddOns) {
       const addOns = await getAllAddOns(
         getFrameworkByName(options.framework || defaultFramework || 'React')!,
-        defaultMode ||
-          convertTemplateToMode(options.template || defaultTemplate),
+        defaultMode,
       )
       let hasConfigurableAddOns = false
       for (const addOn of addOns.filter((a) => !forcedAddOns.includes(a.id))) {
@@ -143,10 +134,14 @@ export function cli({
     if (options.addonDetails) {
       const addOns = await getAllAddOns(
         getFrameworkByName(options.framework || defaultFramework || 'React')!,
-        defaultMode ||
-          convertTemplateToMode(options.template || defaultTemplate),
+        defaultMode,
       )
-      const addOn = addOns.find((a) => a.id === options.addonDetails)
+      const addOn =
+        addOns.find((a) => a.id === options.addonDetails) ??
+        addOns.find(
+          (a) =>
+            a.id.toLowerCase() === options.addonDetails!.toLowerCase(),
+        )
       if (!addOn) {
         console.error(`Add-on '${options.addonDetails}' not found`)
         process.exit(1)
@@ -239,7 +234,6 @@ export function cli({
           projectName,
           framework: framework.id,
         },
-        defaultMode,
         forcedAddOns,
       )
 
@@ -285,33 +279,12 @@ export function cli({
         options.framework || defaultFramework || 'React',
       )!.id
 
-      if (defaultMode) {
-        cliOptions.template = defaultMode as TemplateOptions
-      }
-
-      // Default to Start unless --router-only is specified
-      // Skip this if forcedAddOns already includes 'start' (e.g., from cli-aliases)
-      if (!options.routerOnly && !forcedAddOns.includes('start')) {
-        if (Array.isArray(cliOptions.addOns)) {
-          if (!cliOptions.addOns.includes('start')) {
-            cliOptions.addOns = [...cliOptions.addOns, 'start']
-          }
-        } else if (cliOptions.addOns !== true) {
-          cliOptions.addOns = ['start']
-        }
-        // Also set template to file-router for Start
-        if (!cliOptions.template) {
-          cliOptions.template = 'file-router'
-        }
-      }
-
       let finalOptions: Options | undefined
       if (cliOptions.interactive) {
         cliOptions.addOns = true
       } else {
         finalOptions = await normalizeOptions(
           cliOptions,
-          defaultMode,
           forcedAddOns,
           { forcedDeployment },
         )
@@ -320,7 +293,6 @@ export function cli({
       if (options.ui) {
         const optionsFromCLI = await normalizeOptions(
           cliOptions,
-          defaultMode,
           forcedAddOns,
           { disableNameCheck: true, forcedDeployment },
         )
@@ -346,7 +318,6 @@ export function cli({
       } else {
         intro(`Let's configure your ${appName} application`)
         finalOptions = await promptForCreateOptions(cliOptions, {
-          forcedMode: defaultMode,
           forcedAddOns,
           showDeploymentOptions,
         })
@@ -384,25 +355,6 @@ export function cli({
   function configureCreateCommand(cmd: Command) {
     cmd.argument('[project-name]', 'name of the project')
 
-    if (!defaultMode && craCompatible) {
-      cmd.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
-        },
-      )
-    }
-
     if (!defaultFramework) {
       cmd.option<string>(
         '--framework <type>',
@@ -448,6 +400,14 @@ export function cli({
         '--dev-watch <path>',
         'Watch a framework directory for changes and auto-rebuild',
       )
+      .option(
+        '--router-only',
+        'Deprecated: compatibility flag from create-tsrouter-app',
+      )
+      .option(
+        '--template <type>',
+        'Deprecated: compatibility flag from create-tsrouter-app',
+      )
 
     if (deployments.size > 0) {
       cmd.option<string>(
@@ -486,10 +446,7 @@ export function cli({
     }
 
     cmd
-      .option('--router-only', 'create a Router-only SPA without TanStack Start (SSR)', false)
       .option('--interactive', 'interactive mode', false)
-      .option('--tailwind', 'add Tailwind CSS')
-      .option('--no-tailwind', 'skip Tailwind CSS')
       .option<Array<string> | boolean>(
         '--add-ons [...add-ons]',
         'pick from a list of available add-ons (comma separated list)',
@@ -526,7 +483,7 @@ export function cli({
   }
 
   // === CREATE SUBCOMMAND ===
-  // By default creates a TanStack Start app. Use --router-only for SPA without Start.
+  // Creates a TanStack Start app (file-router mode).
   const createCommand = program
     .command('create')
     .description(`Create a new TanStack Start application`)
@@ -541,7 +498,6 @@ export function cli({
     .option('--sse', 'Run in SSE mode instead of stdio', false)
     .action(async (options: { sse: boolean }) => {
       await runMCPServer(options.sse, {
-        forcedMode: defaultMode,
         forcedAddOns,
         appName,
       })

package/src/command-line.ts

@@ -19,9 +19,54 @@ import type { Options } from '@tanstack/create'
 
 import type { CliOptions } from './types.js'
 
+const SUPPORTED_LEGACY_TEMPLATES = new Set([
+  'file-router',
+  'typescript',
+  'tsx',
+])
+
+export function validateLegacyCreateFlags(cliOptions: CliOptions): {
+  warnings: Array<string>
+  error?: string
+} {
+  const warnings: Array<string> = []
+
+  if (cliOptions.routerOnly) {
+    warnings.push(
+      'The --router-only flag is deprecated and ignored. `tanstack create` already creates router-based apps.',
+    )
+  }
+
+  if (!cliOptions.template) {
+    return { warnings }
+  }
+
+  const template = cliOptions.template.toLowerCase().trim()
+
+  if (template === 'javascript' || template === 'js' || template === 'jsx') {
+    return {
+      warnings,
+      error:
+        'JavaScript/JSX templates are not supported. TanStack Start file-router templates are TypeScript-only.',
+    }
+  }
+
+  if (!SUPPORTED_LEGACY_TEMPLATES.has(template)) {
+    return {
+      warnings,
+      error: `Invalid --template value: ${cliOptions.template}. Supported values are: file-router, typescript, tsx.`,
+    }
+  }
+
+  warnings.push(
+    'The --template flag is deprecated. TypeScript/TSX is the default and only supported template.',
+  )
+
+  return { warnings }
+}
+
 export async function normalizeOptions(
   cliOptions: CliOptions,
-  forcedMode?: string,
   forcedAddOns?: Array<string>,
   opts?: {
     disableNameCheck?: boolean
@@ -51,42 +96,24 @@ export async function normalizeOptions(
     }
   }
 
-  let tailwind = !!cliOptions.tailwind
-
-  let mode: string =
-    forcedMode ||
-    (cliOptions.template === 'file-router' ? 'file-router' : 'code-router')
+  // Mode is always file-router (TanStack Start)
+  let mode = 'file-router'
 
   const starter = cliOptions.starter
     ? await loadStarter(cliOptions.starter)
     : undefined
 
-  // TODO: Make this declarative
-  let typescript =
-    cliOptions.template === 'typescript' ||
-    cliOptions.template === 'file-router' ||
-    cliOptions.framework === 'solid'
+  // TypeScript and Tailwind are always enabled with TanStack Start
+  const typescript = true
+  const tailwind = true
 
   if (starter) {
-    tailwind = starter.tailwind
-    typescript = starter.typescript
     cliOptions.framework = starter.framework
     mode = starter.mode
   }
 
   const framework = getFrameworkById(cliOptions.framework || 'react-cra')!
 
-  if (
-    forcedMode &&
-    framework.supportedModes?.[forcedMode]?.forceTypescript !== undefined
-  ) {
-    typescript = true
-  }
-
-  if (cliOptions.framework === 'solid') {
-    tailwind = true
-  }
-
   async function selectAddOns() {
     // Edge case for Windows Powershell
     if (Array.isArray(cliOptions.addOns) && cliOptions.addOns.length === 1) {
@@ -131,28 +158,6 @@ export async function normalizeOptions(
 
   const chosenAddOns = await selectAddOns()
 
-  if (chosenAddOns.length) {
-    typescript = true
-
-    // Check if any add-on explicitly requires tailwind
-    const addOnsRequireTailwind = chosenAddOns.some(
-      (addOn) => addOn.tailwind === true,
-    )
-
-    // Only set tailwind to true if:
-    // 1. An add-on explicitly requires it, OR
-    // 2. User explicitly set it via CLI
-    if (addOnsRequireTailwind) {
-      tailwind = true
-    } else if (cliOptions.tailwind === true) {
-      tailwind = true
-    } else if (cliOptions.tailwind === false) {
-      tailwind = false
-    }
-    // If cliOptions.tailwind is undefined and no add-ons require it,
-    // leave tailwind as is (will be prompted in interactive mode)
-  }
-
   // Handle add-on configuration option
   let addOnOptionsFromCLI = {}
   if (cliOptions.addOnConfig) {

package/src/mcp.ts

@@ -55,6 +55,11 @@ function createServer({
                   id: addOn.id,
                   name: addOn.name,
                   description: addOn.description,
+                  type: addOn.type,
+                  category: addOn.category,
+                  link: addOn.link,
+                  warning: addOn.warning,
+                  exclusive: addOn.exclusive,
                   options: addOn.options,
                   dependsOn: addOn.dependsOn,
                 })),
@@ -65,6 +70,75 @@ function createServer({
     },
   )
 
+  server.tool(
+    'getAddOnDetails',
+    'Get detailed information about a specific add-on including implementation patterns, routes, dependencies, and documentation',
+    {
+      framework: z
+        .string()
+        .describe(
+          `The framework to use. Available frameworks: ${frameworkNames.join(', ')}`,
+        ),
+      addOnId: z
+        .string()
+        .describe('The ID of the add-on to get details for'),
+    },
+    async ({ framework: frameworkName, addOnId }) => {
+      const framework = getFrameworkByName(frameworkName)!
+      const allAddOns = framework.getAddOns()
+      const addOn =
+        allAddOns.find((a) => a.id === addOnId) ??
+        allAddOns.find(
+          (a) => a.id.toLowerCase() === addOnId.toLowerCase(),
+        )
+
+      if (!addOn) {
+        return {
+          content: [
+            {
+              type: 'text',
+              text: JSON.stringify({ error: `Add-on '${addOnId}' not found` }),
+            },
+          ],
+        }
+      }
+
+      // Get file list for context
+      const files = await addOn.getFiles()
+
+      return {
+        content: [
+          {
+            type: 'text',
+            text: JSON.stringify({
+              id: addOn.id,
+              name: addOn.name,
+              description: addOn.description,
+              type: addOn.type,
+              category: addOn.category,
+              phase: addOn.phase,
+              modes: addOn.modes,
+              link: addOn.link,
+              warning: addOn.warning,
+              exclusive: addOn.exclusive,
+              dependsOn: addOn.dependsOn,
+              options: addOn.options,
+              routes: addOn.routes,
+              packageAdditions: addOn.packageAdditions,
+              shadcnComponents: addOn.shadcnComponents,
+              integrations: addOn.integrations,
+              readme: addOn.readme,
+              files,
+              author: addOn.author,
+              version: addOn.version,
+              license: addOn.license,
+            }),
+          },
+        ],
+      }
+    },
+  )
+
   server.tool(
     'createTanStackApplication',
     'Create a new TanStack application',
@@ -156,7 +230,6 @@ export async function runMCPServer(
     appName,
     name,
   }: {
-    forcedMode?: string
     forcedAddOns?: Array<string>
     appName?: string
     name?: string

package/src/options.ts

@@ -16,10 +16,7 @@ import {
   selectDeployment,
   selectGit,
   selectPackageManager,
-  selectRouterType,
-  selectTailwind,
   selectToolchain,
-  selectTypescript,
 } from './ui-prompts.js'
 
 import {
@@ -35,11 +32,9 @@ export async function promptForCreateOptions(
   cliOptions: CliOptions,
   {
     forcedAddOns = [],
-    forcedMode,
     showDeploymentOptions = false,
   }: {
     forcedAddOns?: Array<string>
-    forcedMode?: string
     showDeploymentOptions?: boolean
   },
 ): Promise<Required<Options> | undefined> {
@@ -81,29 +76,11 @@ export async function promptForCreateOptions(
     }
   }
 
-  // Router type selection
-  if (forcedMode) {
-    options.mode = forcedMode
-  } else if (cliOptions.template) {
-    options.mode =
-      cliOptions.template === 'file-router' ? 'file-router' : 'code-router'
-  } else {
-    options.mode = await selectRouterType()
-  }
+  // Mode is always file-router (TanStack Start)
+  options.mode = 'file-router'
 
-  // TypeScript selection (if using Code Router)
-  // TODO: Make this declarative
-  options.typescript =
-    options.mode === 'file-router' || options.framework.id === 'solid'
-  if (
-    forcedMode &&
-    options.framework.supportedModes[forcedMode].forceTypescript
-  ) {
-    options.typescript = true
-  }
-  if (!options.typescript && options.mode === 'code-router') {
-    options.typescript = await selectTypescript()
-  }
+  // TypeScript is always enabled with file-router
+  options.typescript = true
 
   // Package manager selection
   if (cliOptions.packageManager) {
@@ -170,29 +147,8 @@ export async function promptForCreateOptions(
     await finalizeAddOns(options.framework, options.mode, Array.from(addOns)),
   )
 
-  if (options.chosenAddOns.length) {
-    options.typescript = true
-  }
-
-  // Tailwind selection
-  // Only treat add-ons as requiring tailwind if they explicitly have "tailwind": true
-  const addOnsRequireTailwind = options.chosenAddOns.some(
-    (addOn) => addOn.tailwind === true,
-  )
-
-  if (addOnsRequireTailwind) {
-    // If any add-on explicitly requires tailwind, enable it automatically
-    options.tailwind = true
-  } else if (cliOptions.tailwind !== undefined) {
-    // User explicitly provided a CLI flag, respect it
-    options.tailwind = !!cliOptions.tailwind
-  } else if (options.framework.id === 'react-cra') {
-    // Only show prompt for react-cra when no CLI flag and no add-ons require it
-    options.tailwind = await selectTailwind()
-  } else {
-    // For other frameworks (like solid), default to true
-    options.tailwind = true
-  }
+  // Tailwind is always enabled
+  options.tailwind = true
 
   // Prompt for add-on options in interactive mode
   if (Array.isArray(cliOptions.addOns)) {

package/src/types.ts

@@ -1,11 +1,7 @@
 import type { PackageManager } from '@tanstack/create'
 
-export type TemplateOptions = 'typescript' | 'javascript' | 'file-router'
-
 export interface CliOptions {
-  template?: TemplateOptions
   framework?: string
-  tailwind?: boolean
   packageManager?: PackageManager
   toolchain?: string | false
   deployment?: string
@@ -25,4 +21,5 @@ export interface CliOptions {
   addOnConfig?: string
   force?: boolean
   routerOnly?: boolean
+  template?: string
 }

package/src/ui-prompts.ts

@@ -43,56 +43,6 @@ export async function getProjectName(): Promise<string> {
   return value
 }
 
-export async function selectRouterType(): Promise<string> {
-  const routerType = await select({
-    message: 'Select the router type:',
-    options: [
-      {
-        value: 'file-router',
-        label: 'File Router - File-based routing structure',
-      },
-      {
-        value: 'code-router',
-        label: 'Code Router - Traditional code-based routing',
-      },
-    ],
-    initialValue: 'file-router',
-  })
-
-  if (isCancel(routerType)) {
-    cancel('Operation cancelled.')
-    process.exit(0)
-  }
-
-  return routerType
-}
-
-export async function selectTypescript(): Promise<boolean> {
-  const typescriptEnable = await confirm({
-    message: 'Would you like to use TypeScript?',
-    initialValue: true,
-  })
-  if (isCancel(typescriptEnable)) {
-    cancel('Operation cancelled.')
-    process.exit(0)
-  }
-  return typescriptEnable
-}
-
-export async function selectTailwind(): Promise<boolean> {
-  const tailwind = await confirm({
-    message: 'Would you like to use Tailwind CSS?',
-    initialValue: true,
-  })
-
-  if (isCancel(tailwind)) {
-    cancel('Operation cancelled.')
-    process.exit(0)
-  }
-
-  return tailwind
-}
-
 export async function selectPackageManager(): Promise<PackageManager> {
   const packageManager = await select({
     message: 'Select package manager:',

package/src/utils.ts

@@ -1,13 +1,5 @@
 import { basename } from 'node:path'
 import validatePackageName from 'validate-npm-package-name'
-import type { TemplateOptions } from './types.js'
-
-export function convertTemplateToMode(template: TemplateOptions): string {
-  if (template === 'typescript' || template === 'javascript') {
-    return 'code-router'
-  }
-  return 'file-router'
-}
 
 export function sanitizePackageName(name: string): string {
   return name