@tanstack/create 0.64.0 → 0.66.0

package/dist/frameworks/react/examples/shopify-storefront/assets/src/routes/index.tsx

@@ -0,0 +1,65 @@
+import { Link, createFileRoute } from '@tanstack/react-router'
+
+import '#/components/shop/shop.css'
+import { ProductGrid } from '#/components/shop/product-grid'
+import { FeaturedCollections } from '#/components/FeaturedCollections'
+import { ShopHero } from '#/components/ShopHero'
+import {
+  getCollections,
+  getProducts,
+  getShop,
+} from '#/server/shopify/catalog.functions'
+
+export const Route = createFileRoute('/')({
+  loader: async () => {
+    const [shop, collections, products] = await Promise.all([
+      getShop(),
+      getCollections(),
+      getProducts({ data: { first: 8, sortKey: 'BEST_SELLING' } }),
+    ])
+    return { shop, collections, featured: products.nodes }
+  },
+  head: ({ loaderData }) => ({
+    meta: loaderData
+      ? [
+          { title: loaderData.shop.name },
+          { name: 'description', content: loaderData.shop.description ?? '' },
+        ]
+      : [],
+  }),
+  component: HomePage,
+})
+
+function HomePage() {
+  const { shop, collections, featured } = Route.useLoaderData()
+
+  return (
+    <div className="shop-root min-h-screen">
+      <ShopHero
+        title={shop.name}
+        tagline={shop.description ?? 'A TanStack Start + Shopify storefront.'}
+      />
+
+      {collections.length > 0 && (
+        <section className="mx-auto max-w-7xl px-4 pb-20 sm:px-6 lg:px-8">
+          <FeaturedCollections collections={collections.slice(0, 3)} />
+        </section>
+      )}
+
+      <section className="mx-auto max-w-7xl px-4 pb-24 sm:px-6 lg:px-8">
+        <div className="mb-8 flex items-baseline justify-between">
+          <h2 className="text-2xl font-medium tracking-tight sm:text-3xl">
+            Best sellers
+          </h2>
+          <Link
+            to="/shop"
+            className="text-sm underline underline-offset-4 hover:opacity-80"
+          >
+            Shop all →
+          </Link>
+        </div>
+        <ProductGrid products={featured} />
+      </section>
+    </div>
+  )
+}

package/dist/frameworks/react/examples/shopify-storefront/info.json

@@ -0,0 +1,18 @@
+{
+  "name": "Shopify Storefront",
+  "description": "A polished Shopify storefront starter — TanStack Start + Shopify Storefront API + optional customer accounts. Hosted checkout, deploy anywhere.",
+  "phase": "example",
+  "modes": ["file-router"],
+  "type": "example",
+  "category": "other",
+  "color": "#5A31F4",
+  "priority": 5,
+  "link": "https://shopify.dev/docs/storefronts/headless",
+  "dependsOn": ["shopify"],
+  "default": true,
+  "routes": [
+    { "url": "/", "path": "src/routes/index.tsx", "jsName": "ShopHome" }
+  ],
+  "integrations": [],
+  "variables": []
+}

package/dist/frameworks/react/examples/shopify-storefront/package.json

@@ -0,0 +1,3 @@
+{
+  "dependencies": {}
+}

package/dist/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/dist/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/dist/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/dist/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/dist/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/dist/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/dist/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/dist/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/dist/frameworks/react/project/base/src/components/Header.tsx.ejs

@@ -32,7 +32,40 @@ export default function Header() {
           </Link>
         </h2>
 
-        <div className="ml-auto flex items-center gap-1.5 sm:ml-0 sm:gap-2">
+        <div className="order-3 flex w-full flex-wrap items-center gap-x-4 gap-y-1 pb-1 text-sm font-semibold sm:order-none sm:w-auto sm:flex-nowrap sm:pb-0">
+          <Link to="/" className="nav-link" activeProps={{ className: 'nav-link is-active' }}>
+            Home
+          </Link>
+          <Link
+            to="/about"
+            className="nav-link"
+            activeProps={{ className: 'nav-link is-active' }}
+          >
+            About
+          </Link>
+          <a
+            href="https://tanstack.com/start/latest/docs/framework/react/overview"
+            className="nav-link"
+            target="_blank"
+            rel="noreferrer"
+          >
+            Docs
+          </a>
+          <% if (demoRoutes.length > 0) { %><details className="relative w-full sm:w-auto">
+            <summary className="nav-link list-none cursor-pointer">Demos</summary>
+            <div className="mt-2 min-w-56 rounded-xl border border-[var(--line)] bg-[var(--header-bg)] p-2 shadow-lg sm:absolute sm:right-0">
+              <% for (const route of demoRoutes) { %><a
+                href="<%= route.url %>"
+                className="block rounded-lg px-3 py-2 text-sm text-[var(--sea-ink-soft)] no-underline transition hover:bg-[var(--link-bg-hover)] hover:text-[var(--sea-ink)]"
+              >
+                <%= route.name %>
+              </a>
+              <% } %>
+            </div>
+          </details><% } %>
+        </div>
+
+        <div className="ml-auto flex items-center gap-1.5 sm:gap-2">
           <a
             href="https://x.com/tan_stack"
             target="_blank"
@@ -65,39 +98,6 @@ export default function Header() {
           <% } %>
           <ThemeToggle />
         </div>
-
-        <div className="order-3 flex w-full flex-wrap items-center gap-x-4 gap-y-1 pb-1 text-sm font-semibold sm:order-2 sm:w-auto sm:flex-nowrap sm:pb-0">
-          <Link to="/" className="nav-link" activeProps={{ className: 'nav-link is-active' }}>
-            Home
-          </Link>
-          <Link
-            to="/about"
-            className="nav-link"
-            activeProps={{ className: 'nav-link is-active' }}
-          >
-            About
-          </Link>
-          <a
-            href="https://tanstack.com/start/latest/docs/framework/react/overview"
-            className="nav-link"
-            target="_blank"
-            rel="noreferrer"
-          >
-            Docs
-          </a>
-          <% if (demoRoutes.length > 0) { %><details className="relative w-full sm:w-auto">
-            <summary className="nav-link list-none cursor-pointer">Demos</summary>
-            <div className="mt-2 min-w-56 rounded-xl border border-[var(--line)] bg-[var(--header-bg)] p-2 shadow-lg sm:absolute sm:right-0">
-              <% for (const route of demoRoutes) { %><a
-                href="<%= route.url %>"
-                className="block rounded-lg px-3 py-2 text-sm text-[var(--sea-ink-soft)] no-underline transition hover:bg-[var(--link-bg-hover)] hover:text-[var(--sea-ink)]"
-              >
-                <%= route.name %>
-              </a>
-              <% } %>
-            </div>
-          </details><% } %>
-        </div>
       </nav>
     </header>
   )

package/dist/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/dist/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/dist/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/dist/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/dist/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/dist/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/dist/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/dist/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/dist/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/dist/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/dist/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/dist/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/dist/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/dist/index.js

@@ -14,7 +14,7 @@ export { CONFIG_FILE } from './constants.js';
 export { DEFAULT_PACKAGE_MANAGER, SUPPORTED_PACKAGE_MANAGERS, getPackageManager, } from './package-manager.js';
 export { registerFramework, getFrameworkById, getFrameworkByName, getFrameworks, scanProjectDirectory, scanAddOnDirectories, __testRegisterFramework, __testClearFrameworks, } from './frameworks.js';
 export { writeConfigFileToEnvironment, readConfigFileFromEnvironment, readConfigFile, } from './config-file.js';
-export { cleanUpFiles, cleanUpFileArray, readFileHelper, getBinaryFile, recursivelyGatherFiles, relativePath, toCleanPath, } from './file-helpers.js';
+export { cleanUpFiles, cleanUpFileArray, isDemoFilePath, readFileHelper, getBinaryFile, recursivelyGatherFiles, relativePath, toCleanPath, } from './file-helpers.js';
 export { formatCommand, handleSpecialURL } from './utils.js';
 export { initStarter, compileStarter } from './custom-add-ons/starter.js';
 export { initAddOn, compileAddOn, devAddOn } from './custom-add-ons/add-on.js';

package/dist/integrations/intent.js

@@ -12,7 +12,7 @@ export async function setupIntent(environment, targetDir, options) {
         message: 'Setting up TanStack Intent skill mappings...',
     });
     try {
-        await packageManagerExecute(environment, resolve(targetDir), options.packageManager, '@tanstack/intent', ['install']);
+        await packageManagerExecute(environment, resolve(targetDir), options.packageManager, '@tanstack/intent', ['install', '--map']);
         environment.finishStep('setup-intent', 'TanStack Intent configured');
         s.stop('TanStack Intent configured');
     }

package/dist/types/file-helpers.d.ts

@@ -10,6 +10,7 @@ export declare function getBinaryFile(content: string): string | null;
 export declare function toCleanPath(absolutePath: string, baseDir: string): string;
 export declare function relativePath(from: string, to: string, stripExtension?: boolean): string;
 export declare function isDirectory(path: string): boolean;
+export declare function isDemoFilePath(path?: string): boolean;
 export declare function findFilesRecursively(path: string, files: Record<string, string>): void;
 export declare function recursivelyGatherFiles(path: string, includeProjectFiles?: boolean): Promise<Record<string, string>>;
 export declare function recursivelyGatherFilesFromEnvironment(environment: Environment, path: string, includeProjectFiles?: boolean): Promise<Record<string, string>>;

package/dist/types/index.d.ts

@@ -9,7 +9,7 @@ export { CONFIG_FILE } from './constants.js';
 export { DEFAULT_PACKAGE_MANAGER, SUPPORTED_PACKAGE_MANAGERS, getPackageManager, } from './package-manager.js';
 export { registerFramework, getFrameworkById, getFrameworkByName, getFrameworks, scanProjectDirectory, scanAddOnDirectories, __testRegisterFramework, __testClearFrameworks, } from './frameworks.js';
 export { writeConfigFileToEnvironment, readConfigFileFromEnvironment, readConfigFile, } from './config-file.js';
-export { cleanUpFiles, cleanUpFileArray, readFileHelper, getBinaryFile, recursivelyGatherFiles, relativePath, toCleanPath, } from './file-helpers.js';
+export { cleanUpFiles, cleanUpFileArray, isDemoFilePath, readFileHelper, getBinaryFile, recursivelyGatherFiles, relativePath, toCleanPath, } from './file-helpers.js';
 export { formatCommand, handleSpecialURL } from './utils.js';
 export { initStarter, compileStarter } from './custom-add-ons/starter.js';
 export { initAddOn, compileAddOn, devAddOn } from './custom-add-ons/add-on.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/create",
-  "version": "0.64.0",
+  "version": "0.66.0",
   "description": "TanStack Application Builder Engine",
   "type": "module",
   "main": "./dist/index.js",

package/src/create-app.ts

@@ -1,6 +1,6 @@
 import { basename, resolve } from 'node:path'
 
-import { isBase64 } from './file-helpers.js'
+import { isBase64, isDemoFilePath } from './file-helpers.js'
 import { formatCommand } from './utils.js'
 import { writeConfigFileToEnvironment } from './config-file.js'
 import {
@@ -18,26 +18,6 @@ import { runSpecialSteps } from './special-steps/index.js'
 
 import type { Environment, FileBundleHandler, Options } from './types.js'
 
-function isDemoFilePath(path?: string) {
-  if (!path) return false
-  const normalized = path.replace(/\\/g, '/')
-
-  if (
-    normalized.includes('/routes/demo/') ||
-    normalized.includes('/routes/example/')
-  ) {
-    return true
-  }
-
-  const filename = normalized.split('/').pop() || ''
-  return (
-    filename.startsWith('demo.') ||
-    filename.startsWith('demo-') ||
-    filename.startsWith('example.') ||
-    filename.startsWith('example-')
-  )
-}
-
 function stripExamplesFromOptions(options: Options): Options {
   if (options.includeExamples !== false) {
     return options
@@ -325,6 +305,87 @@ async function seedEnvValues(environment: Environment, options: Options) {
   await environment.writeFile(envLocalPath, envContents)
 }
 
+async function writeEnvExample(environment: Environment, options: Options) {
+  const envExamplePath = resolve(options.targetDir, '.env.example')
+  const existing = environment.exists(envExamplePath)
+    ? await environment.readFile(envExamplePath)
+    : ''
+
+  const declared = new Set<string>()
+  for (const match of existing.matchAll(/^([A-Z_][A-Z0-9_]*)=/gm)) {
+    declared.add(match[1])
+  }
+
+  const sections: Array<string> = []
+  for (const addOn of options.chosenAddOns) {
+    const lines: Array<string> = []
+    for (const envVar of addOn.envVars || []) {
+      if (declared.has(envVar.name)) continue
+      declared.add(envVar.name)
+      if (envVar.description) {
+        const required = envVar.required ? ' (required)' : ''
+        lines.push(`# ${envVar.description}${required}`)
+      }
+      lines.push(`${envVar.name}=`)
+    }
+    if (lines.length > 0) {
+      sections.push(`# ${addOn.name}\n${lines.join('\n')}`)
+    }
+  }
+
+  if (sections.length === 0) return
+
+  const additions = sections.join('\n\n')
+  const newContent = existing
+    ? `${existing.trimEnd()}\n\n${additions}\n`
+    : `${additions}\n`
+
+  await environment.writeFile(envExamplePath, newContent)
+}
+
+const SHIPPING_CATEGORIES = new Set(['auth', 'database', 'orm', 'deploy'])
+
+function buildNextSteps(options: Options): string {
+  const collectedEnv = new Set(Object.keys(options.envVarValues || {}))
+  const listedEnvVars = new Set<string>()
+  const envVarLines: Array<string> = []
+  const docLines: Array<string> = []
+
+  for (const addOn of options.chosenAddOns) {
+    if (addOn.link && addOn.category && SHIPPING_CATEGORIES.has(addOn.category)) {
+      docLines.push(`  • ${addOn.name} (${addOn.category}) — ${addOn.link}`)
+    }
+
+    for (const envVar of addOn.envVars || []) {
+      if (listedEnvVars.has(envVar.name)) continue
+      listedEnvVars.add(envVar.name)
+      const required = envVar.required ? ' (required)' : ''
+      const status = collectedEnv.has(envVar.name)
+        ? ' — already set from your input'
+        : ' — needs a value'
+      const desc = envVar.description ? ` — ${envVar.description}` : ''
+      envVarLines.push(`  • ${envVar.name}${required}${desc}${status}`)
+    }
+  }
+
+  const sections: Array<string> = []
+  if (envVarLines.length > 0) {
+    sections.push(
+      `Environment variables (review/fill in .env.local before deploying):\n${envVarLines.join('\n')}`,
+    )
+  }
+  if (docLines.length > 0) {
+    sections.push(`Docs for the integrations you picked:\n${docLines.join('\n')}`)
+  }
+  if (options.intent) {
+    sections.push(
+      `Working with an AI agent? Your agent config (AGENTS.md / CLAUDE.md) was wired up by TanStack Intent\nwith explicit skill mappings for the libraries you installed. Try asking your agent:\n  • "migrate this Next.js page to TanStack Start"\n  • "add a protected /dashboard route"\n  • "show me how to use TanStack Router search params"`,
+    )
+  }
+
+  return sections.length > 0 ? `\nNext steps:\n\n${sections.join('\n\n')}\n` : ''
+}
+
 function report(environment: Environment, options: Options) {
   const warnings: Array<string> = []
   for (const addOn of options.chosenAddOns) {
@@ -358,6 +419,8 @@ ${environment.getErrors().join('\n')}`
     : `% cd ${options.projectName}
 `
 
+  const nextSteps = buildNextSteps(options)
+
   // Use the force luke! :)
   environment.outro(
     `${locationMessage}
@@ -366,7 +429,7 @@ Use the following commands to start your app:
 ${cdInstruction}% ${formatCommand(
       getPackageManagerScriptCommand(options.packageManager, ['dev']),
     )}
-
+${nextSteps}
 Please read the README.md file for information on testing, styling, adding routes, etc.${errorStatement}`,
   )
 }
@@ -377,6 +440,7 @@ export async function createApp(environment: Environment, options: Options) {
   environment.startRun()
   await writeFiles(environment, effectiveOptions)
   await seedEnvValues(environment, effectiveOptions)
+  await writeEnvExample(environment, effectiveOptions)
   await runCommandsAndInstallDependencies(environment, effectiveOptions)
   environment.finishRun()
 

package/src/file-helpers.ts

@@ -112,6 +112,26 @@ export function isDirectory(path: string): boolean {
   return statSync(path).isDirectory()
 }
 
+export function isDemoFilePath(path?: string): boolean {
+  if (!path) return false
+  const normalized = path.replace(/\\/g, '/')
+
+  if (
+    normalized.includes('/routes/demo/') ||
+    normalized.includes('/routes/example/')
+  ) {
+    return true
+  }
+
+  const filename = normalized.split('/').pop() || ''
+  return (
+    filename.startsWith('demo.') ||
+    filename.startsWith('demo-') ||
+    filename.startsWith('example.') ||
+    filename.startsWith('example-')
+  )
+}
+
 export function findFilesRecursively(
   path: string,
   files: Record<string, string>,

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

@@ -1,6 +1,6 @@
 {
   "name": "AI",
-  "description": "TanStack AI integration and examples.",
+  "description": "Streaming chat UI with model-agnostic backend (OpenAI, Anthropic, etc).",
   "phase": "add-on",
   "modes": ["file-router"],
   "type": "add-on",

package/src/frameworks/react/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",