feat: changing hosting terminology to deployment adapter

jherr · jherr · commit c2ef696839bb · 2025-11-10T20:21:15.000-08:00
diff --git a/cli/create-start-app/src/index.ts b/cli/create-start-app/src/index.ts
@@ -12,7 +12,7 @@ cli({
   appName: 'TanStack Start',
   forcedMode: 'file-router',
   forcedAddOns: ['start'],
-  showHostingOptions: true,
-  forcedHost: 'nitro',
+  showDeploymentOptions: true,
+  forcedDeployment: 'nitro',
   craCompatible: true,
 })
diff --git a/cli/create-tanstack-app/src/index.ts b/cli/create-tanstack-app/src/index.ts
@@ -10,7 +10,7 @@ registerSolid()
 cli({
   name: 'create-tanstack-app',
   appName: 'TanStack',
-  forcedHost: 'nitro',
+  forcedDeployment: 'nitro',
   defaultTemplate: 'file-router',
   craCompatible: true,
 })
diff --git a/cli/create-tanstack/src/index.ts b/cli/create-tanstack/src/index.ts
@@ -10,7 +10,7 @@ registerSolid()
 cli({
   name: 'create-tanstack',
   appName: 'TanStack',
-  forcedHost: 'nitro',
+  forcedDeployment: 'nitro',
   defaultTemplate: 'file-router',
   craCompatible: true,
 })
diff --git a/cli/ts-create-start/src/index.ts b/cli/ts-create-start/src/index.ts
@@ -9,10 +9,10 @@ registerSolid()
 
 cli({
   name: '@tanstack/create-start',
-  forcedHost: 'nitro',
+  forcedDeployment: 'nitro',
   appName: 'TanStack Start',
   forcedMode: 'file-router',
   forcedAddOns: ['start'],
   craCompatible: true,
-  showHostingOptions: true,
+  showDeploymentOptions: true,
 })
diff --git a/frameworks/react-cra/hosts/cloudflare/info.json b/frameworks/react-cra/hosts/cloudflare/info.json
@@ -4,7 +4,7 @@
   "link": "https://developers.cloudflare.com/workers/vite-plugin/",
   "phase": "add-on",
   "modes": ["file-router", "code-router"],
-  "type": "host",
+  "type": "deployment",
   "priority": 200,
   "integrations": [
     {
diff --git a/frameworks/react-cra/hosts/netlify/info.json b/frameworks/react-cra/hosts/netlify/info.json
@@ -4,7 +4,7 @@
   "link": "https://docs.netlify.com",
   "phase": "add-on",
   "modes": ["file-router", "code-router"],
-  "type": "host",
+  "type": "deployment",
   "priority": 180,
   "integrations": [
     {
diff --git a/frameworks/react-cra/hosts/nitro/info.json b/frameworks/react-cra/hosts/nitro/info.json
@@ -4,7 +4,7 @@
   "link": "https://nitro.build/",
   "phase": "add-on",
   "modes": ["file-router", "code-router"],
-  "type": "host",
+  "type": "deployment",
   "priority": 0,
   "integrations": [
     {
diff --git a/frameworks/react-cra/src/checksum.ts b/frameworks/react-cra/src/checksum.ts
@@ -1,3 +1,3 @@
 // This file is auto-generated. Do not edit manually.
 // Generated from add-ons, examples, hosts, project, and toolchains directories
-export const contentChecksum = 'fc2c264c6040b156c6978f56efd469d8b77dfcd50d6fb0b3744a074761e44232'
+export const contentChecksum = '4e120a677f2d05a2dbe492f761bd3fefc02b835ebcdf9511a9ed78ceaa545a41'
diff --git a/frameworks/solid/hosts/cloudflare/info.json b/frameworks/solid/hosts/cloudflare/info.json
@@ -4,7 +4,7 @@
   "link": "https://developers.cloudflare.com/workers/vite-plugin/",
   "phase": "add-on",
   "modes": ["file-router", "code-router"],
-  "type": "host",
+  "type": "deployment",
   "priority": 200,
   "integrations": [
     {
diff --git a/frameworks/solid/hosts/netlify/info.json b/frameworks/solid/hosts/netlify/info.json
@@ -4,7 +4,7 @@
   "link": "https://docs.netlify.com",
   "phase": "add-on",
   "modes": ["file-router", "code-router"],
-  "type": "host",
+  "type": "deployment",
   "priority": 180,
   "integrations": [
     {
diff --git a/frameworks/solid/hosts/nitro/info.json b/frameworks/solid/hosts/nitro/info.json
@@ -4,7 +4,7 @@
   "link": "https://nitro.build/",
   "phase": "add-on",
   "modes": ["file-router", "code-router"],
-  "type": "host",
+  "type": "deployment",
   "integrations": [
     {
       "type": "vite-plugin",
diff --git a/frameworks/solid/src/checksum.ts b/frameworks/solid/src/checksum.ts
@@ -1,3 +1,3 @@
 // This file is auto-generated. Do not edit manually.
 // Generated from add-ons, examples, hosts, project, and toolchains directories
-export const contentChecksum = '5c4bfbdd0a88bbf8a7cc764efab7034d43fa70f36e6d50a6bfb6955d19fff2d0'
+export const contentChecksum = '8e60d2780707119865b8f8ba4274517e4a66391a2f2f62090d954b63716c2a01'
diff --git a/packages/cta-cli/src/cli.ts b/packages/cta-cli/src/cli.ts
@@ -32,30 +32,30 @@ import { convertTemplateToMode } from './utils.js'
 import type { CliOptions, TemplateOptions } from './types.js'
 import type { Options, PackageManager } from '@tanstack/cta-engine'
 
-// This CLI assumes that all of the registered frameworks have the same set of toolchains, hosts, modes, etc.
+// This CLI assumes that all of the registered frameworks have the same set of toolchains, deployments, modes, etc.
 
 export function cli({
   name,
   appName,
   forcedMode,
   forcedAddOns = [],
   defaultTemplate = 'javascript',
-  forcedHost,
+  forcedDeployment,
   defaultFramework,
   craCompatible = false,
   webBase,
-  showHostingOptions = false,
+  showDeploymentOptions = false,
 }: {
   name: string
   appName: string
   forcedMode?: string
   forcedAddOns?: Array<string>
-  forcedHost?: string
+  forcedDeployment?: string
   defaultTemplate?: TemplateOptions
   defaultFramework?: string
   craCompatible?: boolean
   webBase?: string
-  showHostingOptions?: boolean
+  showDeploymentOptions?: boolean
 }) {
   const environment = createUIEnvironment(appName, false)
 
@@ -72,11 +72,11 @@ export function cli({
     }
   }
 
-  const hosts = new Set<string>()
+  const deployments = new Set<string>()
   for (const framework of getFrameworks()) {
     for (const addOn of framework.getAddOns()) {
-      if (addOn.type === 'host') {
-        hosts.add(addOn.id)
+      if (addOn.type === 'deployment') {
+        deployments.add(addOn.id)
       }
     }
   }
@@ -202,7 +202,7 @@ Remove your node_modules directory and package lock file and re-install.`,
           forcedAddOns,
           environmentFactory: () => createUIEnvironment(appName, false),
           webBase,
-          showHostingOptions,
+          showDeploymentOptions,
         })
       } else if (parsedAddOns.length < 1) {
         const addOns = await promptForAddOns()
@@ -308,15 +308,15 @@ Remove your node_modules directory and package lock file and re-install.`,
       },
     )
 
-  if (hosts.size > 0) {
+  if (deployments.size > 0) {
     program.option<string>(
-      `--host <${Array.from(hosts).join('|')}>`,
-      `Explicitly tell the CLI to use this hosting provider`,
+      `--deployment <${Array.from(deployments).join('|')}>`,
+      `Explicitly tell the CLI to use this deployment adapter`,
       (value) => {
-        if (!hosts.has(value)) {
+        if (!deployments.has(value)) {
           throw new InvalidArgumentError(
-            `Invalid host: ${value}. The following are allowed: ${Array.from(
-              hosts,
+            `Invalid adapter: ${value}. The following are allowed: ${Array.from(
+              deployments,
             ).join(', ')}`,
           )
         }
@@ -485,7 +485,7 @@ Remove your node_modules directory and package lock file and re-install.`,
             cliOptions,
             defaultMode,
             forcedAddOns,
-            { forcedHost },
+            { forcedDeployment },
           )
         }
 
@@ -494,7 +494,7 @@ Remove your node_modules directory and package lock file and re-install.`,
             cliOptions,
             defaultMode,
             forcedAddOns,
-            { disableNameCheck: true, forcedHost },
+            { disableNameCheck: true, forcedDeployment },
           )
           const options = {
             ...createSerializedOptions(optionsFromCLI!),
@@ -508,7 +508,7 @@ Remove your node_modules directory and package lock file and re-install.`,
             forcedAddOns,
             environmentFactory: () => createUIEnvironment(appName, false),
             webBase,
-            showHostingOptions,
+            showDeploymentOptions,
           })
           return
         }
@@ -520,7 +520,7 @@ Remove your node_modules directory and package lock file and re-install.`,
           finalOptions = await promptForCreateOptions(cliOptions, {
             forcedMode: defaultMode,
             forcedAddOns,
-            showHostingOptions,
+            showDeploymentOptions,
           })
         }
 
diff --git a/packages/cta-cli/src/command-line.ts b/packages/cta-cli/src/command-line.ts
@@ -19,7 +19,7 @@ export async function normalizeOptions(
   forcedAddOns?: Array<string>,
   opts?: {
     disableNameCheck?: boolean
-    forcedHost?: string
+    forcedDeployment?: string
   },
 ): Promise<Options | undefined> {
   const projectName = (cliOptions.projectName ?? '').trim()
@@ -77,7 +77,7 @@ export async function normalizeOptions(
       starter?.dependsOn ||
       forcedAddOns ||
       cliOptions.toolchain ||
-      cliOptions.host
+      cliOptions.deployment
     ) {
       const selectedAddOns = new Set<string>([
         ...(starter?.dependsOn || []),
@@ -91,12 +91,12 @@ export async function normalizeOptions(
       if (cliOptions.toolchain) {
         selectedAddOns.add(cliOptions.toolchain)
       }
-      if (cliOptions.host) {
-        selectedAddOns.add(cliOptions.host)
+      if (cliOptions.deployment) {
+        selectedAddOns.add(cliOptions.deployment)
       }
 
-      if (!cliOptions.host && opts?.forcedHost) {
-        selectedAddOns.add(opts.forcedHost)
+      if (!cliOptions.deployment && opts?.forcedDeployment) {
+        selectedAddOns.add(opts.forcedDeployment)
       }
 
       return await finalizeAddOns(framework, mode, Array.from(selectedAddOns))
diff --git a/packages/cta-cli/src/options.ts b/packages/cta-cli/src/options.ts
@@ -13,7 +13,7 @@ import {
   promptForAddOnOptions,
   selectAddOns,
   selectGit,
-  selectHost,
+  selectDeployment,
   selectPackageManager,
   selectRouterType,
   selectTailwind,
@@ -30,11 +30,11 @@ export async function promptForCreateOptions(
   {
     forcedAddOns = [],
     forcedMode,
-    showHostingOptions = false,
+    showDeploymentOptions = false,
   }: {
     forcedAddOns?: Array<string>
     forcedMode?: string
-    showHostingOptions?: boolean
+    showDeploymentOptions?: boolean
   },
 ): Promise<Required<Options> | undefined> {
   const options = {} as Required<Options>
@@ -89,9 +89,9 @@ export async function promptForCreateOptions(
     cliOptions.toolchain,
   )
 
-  // Host selection
-  const host = showHostingOptions
-    ? await selectHost(options.framework, cliOptions.host)
+  // Deployment selection
+  const deployment = showDeploymentOptions
+    ? await selectDeployment(options.framework, cliOptions.deployment)
     : undefined
 
   // Add-ons selection
@@ -100,8 +100,8 @@ export async function promptForCreateOptions(
   if (toolchain) {
     addOns.add(toolchain)
   }
-  if (host) {
-    addOns.add(host)
+  if (deployment) {
+    addOns.add(deployment)
   }
 
   for (const addOn of forcedAddOns) {
diff --git a/packages/cta-cli/src/types.ts b/packages/cta-cli/src/types.ts
@@ -8,7 +8,7 @@ export interface CliOptions {
   tailwind?: boolean
   packageManager?: PackageManager
   toolchain?: string
-  host?: string
+  deployment?: string
   projectName?: string
   git?: boolean
   addOns?: Array<string> | boolean
diff --git a/packages/cta-cli/src/ui-prompts.ts b/packages/cta-cli/src/ui-prompts.ts
@@ -232,41 +232,41 @@ export async function promptForAddOnOptions(
   return addOnOptions
 }
 
-export async function selectHost(
+export async function selectDeployment(
   framework: Framework,
-  host?: string,
+  deployment?: string,
 ): Promise<string | undefined> {
-  const hosts = new Set<AddOn>()
+  const deployments = new Set<AddOn>()
   let initialValue: string | undefined = undefined
   for (const addOn of framework
     .getAddOns()
     .sort((a, b) => a.name.localeCompare(b.name))) {
-    if (addOn.type === 'host') {
-      hosts.add(addOn)
-      if (host && addOn.id === host) {
-        return host
+    if (addOn.type === 'deployment') {
+      deployments.add(addOn)
+      if (deployment && addOn.id === deployment) {
+        return deployment
       }
       if (addOn.default) {
         initialValue = addOn.id
       }
     }
   }
 
-  const hp = await select({
-    message: 'Select hosting provider',
+  const dp = await select({
+    message: 'Select deployment adapter',
     options: [
-      ...Array.from(hosts).map((h) => ({
-        value: h.id,
-        label: h.name,
+      ...Array.from(deployments).map((d) => ({
+        value: d.id,
+        label: d.name,
       })),
     ],
     initialValue: initialValue,
   })
 
-  if (isCancel(hp)) {
+  if (isCancel(dp)) {
     cancel('Operation cancelled.')
     process.exit(0)
   }
 
-  return hp
+  return dp
 }
diff --git a/packages/cta-cli/tests/command-line.test.ts b/packages/cta-cli/tests/command-line.test.ts
@@ -102,7 +102,7 @@ describe('normalizeOptions', () => {
     const options = await normalizeOptions({
       projectName: 'test',
       starter: 'https://github.com/cta-dev/cta-starter-solid',
-      host: 'nitro',
+      deployment: 'nitro',
     })
     expect(options?.mode).toBe('file-router')
     expect(options?.tailwind).toBe(true)
diff --git a/packages/cta-engine/src/create-app.ts b/packages/cta-engine/src/create-app.ts
@@ -48,7 +48,7 @@ async function writeFiles(environment: Environment, options: Options) {
   environment.finishStep('write-framework-files', 'Framework files written')
 
   let wroteAddonFiles = false
-  for (const type of ['add-on', 'example', 'toolchain', 'host']) {
+  for (const type of ['add-on', 'example', 'toolchain', 'deployment']) {
     for (const phase of ['setup', 'add-on', 'example']) {
       for (const addOn of options.chosenAddOns.filter(
         (addOn) => addOn.phase === phase && addOn.type === type,
diff --git a/packages/cta-engine/src/types.ts b/packages/cta-engine/src/types.ts
@@ -37,7 +37,7 @@ export const AddOnBaseSchema = z.object({
   link: z.string().optional(),
   license: z.string().optional(),
   warning: z.string().optional(),
-  type: z.enum(['add-on', 'example', 'starter', 'toolchain', 'host']),
+  type: z.enum(['add-on', 'example', 'starter', 'toolchain', 'deployment']),
   priority: z.number().optional(),
   command: z
     .object({
diff --git a/packages/cta-ui-base/src/components/sidebar-items/add-ons.tsx b/packages/cta-ui-base/src/components/sidebar-items/add-ons.tsx
diff --git a/packages/cta-ui-base/src/store/add-ons.ts b/packages/cta-ui-base/src/store/add-ons.ts
diff --git a/packages/cta-ui-base/src/store/project.ts b/packages/cta-ui-base/src/store/project.ts
diff --git a/packages/cta-ui-base/src/types.d.ts b/packages/cta-ui-base/src/types.d.ts
diff --git a/packages/cta-ui/lib/engine-handling/generate-initial-payload.ts b/packages/cta-ui/lib/engine-handling/generate-initial-payload.ts
diff --git a/packages/cta-ui/lib/engine-handling/server-environment.ts b/packages/cta-ui/lib/engine-handling/server-environment.ts
diff --git a/packages/cta-ui/lib/index.ts b/packages/cta-ui/lib/index.ts
diff --git a/packages/cta-ui/lib/types.d.ts b/packages/cta-ui/lib/types.d.ts
diff --git a/packages/cta-ui/src/types.d.ts b/packages/cta-ui/src/types.d.ts

Original file line number	Diff line number	Diff line change
`@@ -4,7 +4,7 @@`
`4`	`4`	`"link": "https://developers.cloudflare.com/workers/vite-plugin/",`
`5`	`5`	`"phase": "add-on",`
`6`	`6`	`"modes": ["file-router", "code-router"],`
`7`		`- "type": "host",`
	`7`	`+ "type": "deployment",`
`8`	`8`	`"priority": 200,`
`9`	`9`	`"integrations": [`
`10`	`10`	`{`
Original file line number	Diff line number	Diff line change
`@@ -4,7 +4,7 @@`
`4`	`4`	`"link": "https://docs.netlify.com",`
`5`	`5`	`"phase": "add-on",`
`6`	`6`	`"modes": ["file-router", "code-router"],`
`7`		`- "type": "host",`
	`7`	`+ "type": "deployment",`
`8`	`8`	`"priority": 180,`
`9`	`9`	`"integrations": [`
`10`	`10`	`{`
Original file line number	Diff line number	Diff line change
`@@ -4,7 +4,7 @@`
`4`	`4`	`"link": "https://nitro.build/",`
`5`	`5`	`"phase": "add-on",`
`6`	`6`	`"modes": ["file-router", "code-router"],`
`7`		`- "type": "host",`
	`7`	`+ "type": "deployment",`
`8`	`8`	`"priority": 0,`
`9`	`9`	`"integrations": [`
`10`	`10`	`{`