@tanstack/create 0.63.9 → 0.65.0

package/src/frameworks/react/add-ons/mcp/info.json

@@ -1,7 +1,7 @@
 {
   "name": "MCP",
   "phase": "setup",
-  "description": "Add Model Context Protocol (MCP) support.",
+  "description": "Expose your app as an MCP server so AI clients (Claude, Cursor) can call into it.",
   "link": "https://mcp.dev",
   "modes": ["file-router"],
   "type": "add-on",

package/src/frameworks/react/add-ons/neon/info.json

@@ -1,6 +1,6 @@
 {
   "name": "Neon",
-  "description": "Add the Neon database to your application.",
+  "description": "Serverless Postgres (auto-scales to zero, branchable per environment).",
   "link": "https://neon.com",
   "phase": "add-on",
   "type": "add-on",

package/src/frameworks/react/add-ons/paraglide/info.json

@@ -1,6 +1,6 @@
 {
   "name": "Paraglide (i18n)",
-  "description": "i18n with localized routing",
+  "description": "Type-safe i18n with localized routing and message bundles.",
   "phase": "add-on",
   "modes": ["file-router"],
   "type": "add-on",

package/src/frameworks/react/add-ons/prisma/info.json

@@ -1,6 +1,6 @@
 {
   "name": "Prisma",
-  "description": "Add Prisma Postgres, or Prisma ORM with other DBs to your application.",
+  "description": "Type-safe database client with schema migrations (Postgres, MySQL, SQLite, MongoDB).",
   "phase": "add-on",
   "type": "add-on",
   "category": "orm",

package/src/frameworks/react/add-ons/shadcn/info.json

@@ -1,6 +1,6 @@
 {
   "name": "Shadcn",
-  "description": "Add Shadcn UI to your application.",
+  "description": "Copy-paste accessible UI components (Tailwind + Radix primitives).",
   "phase": "add-on",
   "modes": ["file-router", "code-router"],
   "link": "https://ui.shadcn.com/",

package/src/frameworks/react/add-ons/strapi/info.json

@@ -1,6 +1,6 @@
 {
   "name": "Strapi",
-  "description": "Use the Strapi CMS to manage your content.",
+  "description": "Headless CMS with admin UI (self-hosted, content models in TypeScript).",
   "link": "https://strapi.io/",
   "phase": "add-on",
   "type": "add-on",

package/src/frameworks/react/add-ons/t3env/info.json

@@ -1,6 +1,6 @@
 {
   "name": "T3Env",
-  "description": "Add type safety to your environment variables",
+  "description": "Validate process.env at build time (catch missing/wrong env vars before runtime).",
   "phase": "add-on",
   "type": "add-on",
   "category": "tooling",

package/src/frameworks/react/add-ons/workos/info.json

@@ -1,6 +1,6 @@
 {
   "name": "WorkOS",
-  "description": "Add WorkOS authentication to your application.",
+  "description": "Enterprise SSO, SAML, and directory sync (good for B2B apps).",
   "phase": "add-on",
   "modes": ["file-router"],
   "type": "add-on",

package/src/frameworks/react/hosts/cloudflare/README.md

@@ -0,0 +1,11 @@
+## Deploy to Cloudflare Workers
+
+This project uses the Cloudflare Vite plugin (configured in `vite.config.ts`) and `wrangler.jsonc`:
+
+1. Install Wrangler: `npm install -g wrangler`
+2. Authenticate: `wrangler login`
+3. Deploy: `npx wrangler deploy`
+
+For production env vars, run `wrangler secret put MY_VAR` for each secret listed in `.env.example`. Public (non-secret) vars go in `wrangler.jsonc` under `vars`.
+
+KV, D1, R2, and Durable Object bindings are configured in `wrangler.jsonc` — see https://developers.cloudflare.com/workers/wrangler/configuration/.

package/src/frameworks/react/hosts/cloudflare/info.json

@@ -1,6 +1,6 @@
 {
   "name": "Cloudflare",
-  "description": "Cloudflare deployment setup",
+  "description": "Deploy to Cloudflare Workers (edge runtime, KV/D1/R2 bindings).",
   "link": "https://developers.cloudflare.com/workers/vite-plugin/",
   "phase": "add-on",
   "modes": ["file-router", "code-router"],

package/src/frameworks/react/hosts/netlify/README.md

@@ -0,0 +1,11 @@
+## Deploy to Netlify
+
+This project ships with `netlify.toml` configured for a Netlify site:
+
+1. Push this repo to GitHub
+2. Visit https://app.netlify.com/start and import the repo
+3. Netlify auto-detects the build (`vite build` → `dist/client`)
+4. Open **Site settings → Environment variables** and add anything from `.env.example` that needs a real value in production
+5. Trigger the first deploy
+
+Server functions and API routes run on Netlify Functions. For lower-latency request handling, see Netlify Edge Functions: https://docs.netlify.com/edge-functions/overview.

package/src/frameworks/react/hosts/netlify/info.json

@@ -1,6 +1,6 @@
 {
   "name": "Netlify",
-  "description": "Netlify deployment setup",
+  "description": "Deploy to Netlify (Functions and Edge Functions, GitHub-driven).",
   "link": "https://docs.netlify.com",
   "phase": "add-on",
   "modes": ["file-router", "code-router"],

package/src/frameworks/react/hosts/nitro/README.md

@@ -0,0 +1,12 @@
+## Deploy with Nitro
+
+This project uses Nitro as a generic server adapter, so it can run on any Node-compatible host.
+
+```bash
+npm run build
+node dist/server/index.mjs
+```
+
+The build output is a self-contained Node server. To deploy, push the `dist/` directory to your host (Render, Fly.io, your own VPS, etc.) and run the server command above.
+
+For host-specific presets (Vercel, Netlify, Cloudflare, AWS Lambda, etc.) and tuning, see https://v3.nitro.build/deploy.

package/src/frameworks/react/hosts/nitro/info.json

@@ -1,6 +1,6 @@
 {
   "name": "Nitro (agnostic)",
-  "description": "Nitro deployment setup",
+  "description": "Generic Nitro adapter (deploy to any Node-compatible host).",
   "link": "https://v3.nitro.build/",
   "phase": "add-on",
   "modes": ["file-router", "code-router"],

package/src/frameworks/react/hosts/railway/README.md

@@ -0,0 +1,10 @@
+## Deploy to Railway
+
+This project ships with `nixpacks.toml` so Railway detects the build automatically:
+
+1. Push this repo to GitHub
+2. Visit https://railway.com/new and create a project from your repo
+3. In the **Variables** tab, add the entries from `.env.example` with their production values
+4. Railway runs `vite build` and serves from `dist/client`
+
+Need a database? Click **+ New** in your project to provision Postgres, MySQL, or Redis directly into the same environment — the connection string is auto-injected as `DATABASE_URL`.

package/src/frameworks/react/hosts/railway/info.json

@@ -1,6 +1,6 @@
 {
   "name": "Railway",
-  "description": "Railway deployment setup",
+  "description": "Deploy to Railway (full-stack PaaS for Node + databases).",
   "link": "https://railway.com/",
   "phase": "add-on",
   "modes": ["file-router", "code-router"],

package/src/frameworks/solid/add-ons/better-auth/info.json

@@ -1,6 +1,6 @@
 {
   "name": "Better Auth",
-  "description": "Add Better Auth authentication to your application.",
+  "description": "Self-hosted user accounts and sessions (open source, full control).",
   "phase": "add-on",
   "type": "add-on",
   "category": "auth",

package/src/frameworks/solid/add-ons/convex/info.json

@@ -1,6 +1,6 @@
 {
   "name": "Convex",
-  "description": "Add the Convex database to your application.",
+  "description": "Reactive document database with real-time queries and serverless functions.",
   "link": "https://convex.dev",
   "phase": "add-on",
   "type": "add-on",

package/src/frameworks/solid/add-ons/solid-ui/info.json

@@ -1,6 +1,6 @@
 {
   "name": "Solid-UI",
-  "description": "Add Solid-UI to your application.",
+  "description": "Copy-paste accessible UI components for Solid (Tailwind + Radix-style primitives).",
   "phase": "add-on",
   "link": "https://ui.shadcn.com/",
   "modes": ["file-router", "code-router"],

package/src/frameworks/solid/add-ons/strapi/info.json

@@ -1,6 +1,6 @@
 {
   "name": "Strapi",
-  "description": "Use the Strapi CMS to manage your content.",
+  "description": "Headless CMS with admin UI (self-hosted, content models in TypeScript).",
   "link": "https://strapi.io/",
   "phase": "add-on",
   "type": "add-on",

package/src/frameworks/solid/add-ons/t3env/info.json

@@ -1,6 +1,6 @@
 {
   "name": "T3Env",
-  "description": "Add type safety to your environment variables",
+  "description": "Validate process.env at build time (catch missing/wrong env vars before runtime).",
   "phase": "add-on",
   "link": "https://github.com/t3-oss/t3-env",
   "type": "add-on",

package/src/frameworks/solid/hosts/cloudflare/README.md

@@ -0,0 +1,11 @@
+## Deploy to Cloudflare Workers
+
+This project uses the Cloudflare Vite plugin (configured in `vite.config.ts`) and `wrangler.jsonc`:
+
+1. Install Wrangler: `npm install -g wrangler`
+2. Authenticate: `wrangler login`
+3. Deploy: `npx wrangler deploy`
+
+For production env vars, run `wrangler secret put MY_VAR` for each secret listed in `.env.example`. Public (non-secret) vars go in `wrangler.jsonc` under `vars`.
+
+KV, D1, R2, and Durable Object bindings are configured in `wrangler.jsonc` — see https://developers.cloudflare.com/workers/wrangler/configuration/.

package/src/frameworks/solid/hosts/cloudflare/info.json

@@ -1,6 +1,6 @@
 {
   "name": "Cloudflare",
-  "description": "Cloudflare deployment setup",
+  "description": "Deploy to Cloudflare Workers (edge runtime, KV/D1/R2 bindings).",
   "link": "https://developers.cloudflare.com/workers/vite-plugin/",
   "phase": "add-on",
   "modes": ["file-router", "code-router"],

package/src/frameworks/solid/hosts/netlify/README.md

@@ -0,0 +1,11 @@
+## Deploy to Netlify
+
+This project ships with `netlify.toml` configured for a Netlify site:
+
+1. Push this repo to GitHub
+2. Visit https://app.netlify.com/start and import the repo
+3. Netlify auto-detects the build (`vite build` → `dist/client`)
+4. Open **Site settings → Environment variables** and add anything from `.env.example` that needs a real value in production
+5. Trigger the first deploy
+
+Server functions and API routes run on Netlify Functions. For lower-latency request handling, see Netlify Edge Functions: https://docs.netlify.com/edge-functions/overview.

package/src/frameworks/solid/hosts/netlify/info.json

@@ -1,6 +1,6 @@
 {
   "name": "Netlify",
-  "description": "Netlify deployment setup",
+  "description": "Deploy to Netlify (Functions and Edge Functions, GitHub-driven).",
   "link": "https://docs.netlify.com",
   "phase": "add-on",
   "modes": ["file-router", "code-router"],

package/src/frameworks/solid/hosts/nitro/README.md

@@ -0,0 +1,12 @@
+## Deploy with Nitro
+
+This project uses Nitro as a generic server adapter, so it can run on any Node-compatible host.
+
+```bash
+npm run build
+node dist/server/index.mjs
+```
+
+The build output is a self-contained Node server. To deploy, push the `dist/` directory to your host (Render, Fly.io, your own VPS, etc.) and run the server command above.
+
+For host-specific presets (Vercel, Netlify, Cloudflare, AWS Lambda, etc.) and tuning, see https://v3.nitro.build/deploy.

package/src/frameworks/solid/hosts/nitro/info.json

@@ -1,6 +1,6 @@
 {
   "name": "Nitro (agnostic)",
-  "description": "Nitro deployment setup",
+  "description": "Generic Nitro adapter (deploy to any Node-compatible host).",
   "link": "https://v3.nitro.build/",
   "phase": "add-on",
   "modes": ["file-router", "code-router"],

package/src/frameworks/solid/hosts/railway/README.md

@@ -0,0 +1,10 @@
+## Deploy to Railway
+
+This project ships with `nixpacks.toml` so Railway detects the build automatically:
+
+1. Push this repo to GitHub
+2. Visit https://railway.com/new and create a project from your repo
+3. In the **Variables** tab, add the entries from `.env.example` with their production values
+4. Railway runs `vite build` and serves from `dist/client`
+
+Need a database? Click **+ New** in your project to provision Postgres, MySQL, or Redis directly into the same environment — the connection string is auto-injected as `DATABASE_URL`.

package/src/frameworks/solid/hosts/railway/info.json

@@ -1,6 +1,6 @@
 {
   "name": "Railway",
-  "description": "Railway deployment setup",
+  "description": "Deploy to Railway (full-stack PaaS for Node + databases).",
   "link": "https://railway.com/",
   "phase": "add-on",
   "modes": ["file-router", "code-router"],

package/src/index.ts

@@ -51,6 +51,7 @@ export {
 export {
   cleanUpFiles,
   cleanUpFileArray,
+  isDemoFilePath,
   readFileHelper,
   getBinaryFile,
   recursivelyGatherFiles,

package/src/integrations/intent.ts

@@ -0,0 +1,47 @@
+import { resolve } from 'node:path'
+
+import { packageManagerExecute } from '../package-manager.js'
+
+import type { Environment, Options } from '../types.js'
+
+export async function setupIntent(
+  environment: Environment,
+  targetDir: string,
+  options: Options,
+) {
+  if (!options.intent) {
+    return
+  }
+
+  const s = environment.spinner()
+  s.start('Setting up TanStack Intent skill mappings...')
+  environment.startStep({
+    id: 'setup-intent',
+    type: 'command',
+    message: 'Setting up TanStack Intent skill mappings...',
+  })
+
+  try {
+    await packageManagerExecute(
+      environment,
+      resolve(targetDir),
+      options.packageManager,
+      '@tanstack/intent',
+      ['install', '--map'],
+    )
+    environment.finishStep('setup-intent', 'TanStack Intent configured')
+    s.stop('TanStack Intent configured')
+  } catch (error) {
+    const message =
+      error instanceof Error ? error.message : 'Unknown error'
+    environment.finishStep(
+      'setup-intent',
+      `TanStack Intent setup skipped: ${message}`,
+    )
+    s.stop('TanStack Intent setup skipped')
+    environment.warn(
+      'TanStack Intent setup failed',
+      `Continuing without it. You can run it later with: npx @tanstack/intent install\n\n${message}`,
+    )
+  }
+}

package/src/types.ts

@@ -214,6 +214,7 @@ export interface Options {
   packageManager: PackageManager
   git: boolean
   install?: boolean
+  intent: boolean
 
   chosenAddOns: Array<AddOn>
   addOnOptions: Record<string, Record<string, any>>

package/tests/create-app.test.ts

@@ -194,4 +194,99 @@ describe('createApp', () => {
 
     expect(output.files['/src/components/demo-AIAssistant.tsx']).toBeDefined()
   })
+
+  it('writes .env.example from add-on envVars metadata', async () => {
+    const { environment, output } = createMemoryEnvironment()
+
+    await createApp(environment, {
+      ...simpleOptions,
+      chosenAddOns: [
+        {
+          id: 'fake-auth',
+          name: 'Fake Auth',
+          type: 'add-on',
+          phase: 'add-on',
+          packageAdditions: { dependencies: {}, devDependencies: {} },
+          routes: [],
+          integrations: [],
+          envVars: [
+            {
+              name: 'AUTH_SECRET',
+              description: 'Random secret used to sign sessions',
+              required: true,
+            },
+            {
+              name: 'AUTH_URL',
+              description: 'Base URL for auth callbacks',
+              required: false,
+            },
+          ],
+          getFiles: () => [],
+          getFileContents: () => '',
+          getDeletedFiles: () => [],
+        } as unknown as AddOn,
+      ],
+    } as Options)
+
+    const envExample = output.files['/.env.example']
+    expect(envExample).toBeDefined()
+    expect(envExample).toContain('# Fake Auth')
+    expect(envExample).toContain(
+      '# Random secret used to sign sessions (required)',
+    )
+    expect(envExample).toContain('AUTH_SECRET=')
+    expect(envExample).toContain('# Base URL for auth callbacks')
+    expect(envExample).toContain('AUTH_URL=')
+  })
+
+  it('does not write .env.example when no add-on declares envVars', async () => {
+    const { environment, output } = createMemoryEnvironment()
+
+    await createApp(environment, {
+      ...simpleOptions,
+      chosenAddOns: [],
+    } as Options)
+
+    expect(output.files['/.env.example']).toBeUndefined()
+  })
+
+  it('dedupes env vars across add-ons in .env.example', async () => {
+    const { environment, output } = createMemoryEnvironment()
+
+    await createApp(environment, {
+      ...simpleOptions,
+      chosenAddOns: [
+        {
+          id: 'addon-a',
+          name: 'Addon A',
+          type: 'add-on',
+          phase: 'add-on',
+          packageAdditions: { dependencies: {}, devDependencies: {} },
+          routes: [],
+          integrations: [],
+          envVars: [{ name: 'SHARED_KEY', required: true }],
+          getFiles: () => [],
+          getFileContents: () => '',
+          getDeletedFiles: () => [],
+        } as unknown as AddOn,
+        {
+          id: 'addon-b',
+          name: 'Addon B',
+          type: 'add-on',
+          phase: 'add-on',
+          packageAdditions: { dependencies: {}, devDependencies: {} },
+          routes: [],
+          integrations: [],
+          envVars: [{ name: 'SHARED_KEY', required: true }],
+          getFiles: () => [],
+          getFileContents: () => '',
+          getDeletedFiles: () => [],
+        } as unknown as AddOn,
+      ],
+    } as Options)
+
+    const envExample = output.files['/.env.example'] || ''
+    const occurrences = envExample.match(/^SHARED_KEY=/gm) || []
+    expect(occurrences.length).toBe(1)
+  })
 })