@tanstack/create 0.64.0 → 0.65.0

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @tanstack/create
 
+## 0.65.0
+
+### Minor Changes
+
+- feat(cli, create): close the gap between `tanstack create` and shipping a real app ([#445](https://github.com/TanStack/cli/pull/445))
+
+  A bundle of UX improvements aimed at beginners (especially those coming from Next.js) and the AI agents they pair with:
+
+  - **Tailored post-creation next steps.** The scaffold completion message now lists the env vars you still need to fill in `.env.local`, links the docs for each shipping-critical integration you picked (auth, database, ORM, deployment), and surfaces the Intent-wired AGENTS.md / CLAUDE.md with concrete prompt examples.
+  - **Pre-creation review screen.** After interactive prompts, the CLI shows a categorized summary (auth, database, ORM, deploy, other) and asks for confirmation before writing files. Conflicting selections (two auth providers, two ORMs, etc.) are flagged in the same step.
+  - **`.env.example` generation.** A checked-in `.env.example` is now derived from the env-var schemas of selected add-ons, with descriptions and a `(required)` marker. Plays nicely with add-ons that ship their own `_dot_env.example.append`.
+  - **Better add-on descriptions.** Concept-first one-liners replace generic "Add X to your application." Reads like a menu instead of a list of brand names.
+  - **Deployment quickstarts.** Each `--deployment` host (Netlify, Cloudflare, Railway, Nitro) now contributes its own README section explaining the actual steps to ship — push, dashboard URL, env var sync.
+  - **Clerk demo route parity.** Clerk's scaffold now ships a proper sign-in flow (matching Better Auth's depth) using Clerk's prebuilt components, plus a richer README with route-protection patterns and a production checklist.
+  - **Intent install passes `--map`.** The auto-invoked `intent install` now writes explicit task→skill mappings into the agent config instead of relying on runtime discovery, so agents see directly which skill matches which task.
+  - **`tanstack clean-demos` command.** A new subcommand removes leftover `demo.*` and `example.*` files (and prunes empty `routes/demo`/`routes/example` directories) so a beginner can ship without the scaffold's training wheels.
+
 ## 0.64.0
 
 ### Minor Changes

package/dist/create-app.js

@@ -1,5 +1,5 @@
 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 { getPackageManagerScriptCommand, packageManagerInstall, translateExecuteCommand, } from './package-manager.js';
@@ -10,20 +10,6 @@ import { installShadcnComponents } from './integrations/shadcn.js';
 import { setupGit } from './integrations/git.js';
 import { setupIntent } from './integrations/intent.js';
 import { runSpecialSteps } from './special-steps/index.js';
-function isDemoFilePath(path) {
-    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) {
     if (options.includeExamples !== false) {
         return options;
@@ -240,6 +226,74 @@ async function seedEnvValues(environment, options) {
     }
     await environment.writeFile(envLocalPath, envContents);
 }
+async function writeEnvExample(environment, options) {
+    const envExamplePath = resolve(options.targetDir, '.env.example');
+    const existing = environment.exists(envExamplePath)
+        ? await environment.readFile(envExamplePath)
+        : '';
+    const declared = new Set();
+    for (const match of existing.matchAll(/^([A-Z_][A-Z0-9_]*)=/gm)) {
+        declared.add(match[1]);
+    }
+    const sections = [];
+    for (const addOn of options.chosenAddOns) {
+        const lines = [];
+        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) {
+    const collectedEnv = new Set(Object.keys(options.envVarValues || {}));
+    const listedEnvVars = new Set();
+    const envVarLines = [];
+    const docLines = [];
+    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 = [];
+    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, options) {
     const warnings = [];
     for (const addOn of options.chosenAddOns) {
@@ -268,12 +322,13 @@ ${environment.getErrors().join('\n')}`;
         ? ''
         : `% cd ${options.projectName}
 `;
+    const nextSteps = buildNextSteps(options);
     // Use the force luke! :)
     environment.outro(`${locationMessage}
 
 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}`);
 }
 export async function createApp(environment, options) {
@@ -281,6 +336,7 @@ export async function createApp(environment, options) {
     environment.startRun();
     await writeFiles(environment, effectiveOptions);
     await seedEnvValues(environment, effectiveOptions);
+    await writeEnvExample(environment, effectiveOptions);
     await runCommandsAndInstallDependencies(environment, effectiveOptions);
     environment.finishRun();
     report(environment, effectiveOptions);

package/dist/file-helpers.js

@@ -90,6 +90,20 @@ export function relativePath(from, to, stripExtension = false) {
 export function isDirectory(path) {
     return statSync(path).isDirectory();
 }
+export function isDemoFilePath(path) {
+    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, files) {
     const dirFiles = readdirSync(path);
     for (const file of dirFiles) {

package/dist/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/dist/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",

package/dist/frameworks/react/add-ons/clerk/README.md

@@ -1,3 +1,44 @@
 ## Setting up Clerk
 
-- Set the `VITE_CLERK_PUBLISHABLE_KEY` in your `.env.local`.
+1. Sign up at [clerk.com](https://clerk.com) and create an application
+2. Copy the **Publishable Key** from the Clerk dashboard
+3. Set it in your `.env.local`:
+   ```bash
+   VITE_CLERK_PUBLISHABLE_KEY=pk_test_...
+   ```
+4. Visit the demo route at `/demo/clerk` once `npm run dev` is running
+
+### What's wired up
+
+- **`<ClerkProvider>`** at the app root (`src/integrations/clerk/provider.tsx`) handles auth context for the whole tree
+- **`<SignInButton>` / `<UserButton>`** in the header swap based on auth state
+- **`/demo/clerk`** shows Clerk's prebuilt sign-in UI and a signed-in greeting
+
+### Protecting a route
+
+Wrap any component in `<SignedIn>` / `<SignedOut>`:
+
+```tsx
+import { SignedIn, SignedOut, RedirectToSignIn } from '@clerk/clerk-react'
+
+function ProtectedPage() {
+  return (
+    <>
+      <SignedIn>
+        <YourPageContent />
+      </SignedIn>
+      <SignedOut>
+        <RedirectToSignIn />
+      </SignedOut>
+    </>
+  )
+}
+```
+
+For server-side checks (route loaders, server functions), see the Clerk docs on [`auth()`](https://clerk.com/docs/references/backend/auth).
+
+### Production checklist
+
+- Replace the test keys with **production keys** from a dedicated production Clerk instance
+- Configure your production domain under **Domains** in the Clerk dashboard
+- Set up social providers (Google, GitHub, etc.) under **User & Authentication → Social Connections**

package/dist/frameworks/react/add-ons/clerk/assets/src/routes/demo/clerk.tsx

@@ -1,20 +1,103 @@
 import { createFileRoute } from '@tanstack/react-router'
-import { useUser } from '@clerk/clerk-react'
+import {
+  SignIn,
+  SignedIn,
+  SignedOut,
+  useUser,
+} from '@clerk/clerk-react'
 
 export const Route = createFileRoute('/demo/clerk')({
-  component: App,
+  component: ClerkDemo,
 })
 
-function App() {
-  const { isSignedIn, user, isLoaded } = useUser()
+function ClerkDemo() {
+  return (
+    <div className="flex justify-center py-10 px-4">
+      <div className="w-full max-w-md p-6 space-y-6">
+        <SignedOut>
+          <div className="space-y-1.5">
+            <h1 className="text-lg font-semibold leading-none tracking-tight">
+              Sign in to continue
+            </h1>
+            <p className="text-sm text-neutral-500 dark:text-neutral-400">
+              Clerk renders the sign-in UI, manages sessions, and handles social providers for you.
+            </p>
+          </div>
+          <div className="flex justify-center pt-2">
+            <SignIn routing="hash" />
+          </div>
+          <p className="text-xs text-center text-neutral-400 dark:text-neutral-500">
+            Built with{' '}
+            <a
+              href="https://clerk.com"
+              target="_blank"
+              rel="noopener noreferrer"
+              className="font-medium hover:text-neutral-600 dark:hover:text-neutral-300"
+            >
+              CLERK
+            </a>
+            .
+          </p>
+        </SignedOut>
 
-  if (!isLoaded) {
-    return <div className="p-4">Loading...</div>
-  }
+        <SignedIn>
+          <SignedInGreeting />
+        </SignedIn>
+      </div>
+    </div>
+  )
+}
+
+function SignedInGreeting() {
+  const { user } = useUser()
+  if (!user) return null
+
+  const email = user.primaryEmailAddress?.emailAddress
+  const initial = (user.firstName || email || 'U').charAt(0).toUpperCase()
+
+  return (
+    <div className="space-y-6">
+      <div className="space-y-1.5">
+        <h1 className="text-lg font-semibold leading-none tracking-tight">
+          Welcome back
+        </h1>
+        <p className="text-sm text-neutral-500 dark:text-neutral-400">
+          You're signed in as {email}
+        </p>
+      </div>
 
-  if (!isSignedIn) {
-    return <div className="p-4">Sign in to view this page</div>
-  }
+      <div className="flex items-center gap-3">
+        {user.imageUrl ? (
+          <img src={user.imageUrl} alt="" className="h-10 w-10 rounded-full" />
+        ) : (
+          <div className="h-10 w-10 bg-neutral-200 dark:bg-neutral-800 flex items-center justify-center rounded-full">
+            <span className="text-sm font-medium text-neutral-600 dark:text-neutral-400">
+              {initial}
+            </span>
+          </div>
+        )}
+        <div className="flex-1 min-w-0">
+          <p className="text-sm font-medium truncate">
+            {user.firstName} {user.lastName}
+          </p>
+          <p className="text-xs text-neutral-500 dark:text-neutral-400 truncate">
+            {email}
+          </p>
+        </div>
+      </div>
 
-  return <div className="p-4">Hello {user.firstName}!</div>
+      <p className="text-xs text-center text-neutral-400 dark:text-neutral-500">
+        Manage your account from the avatar in the header. Built with{' '}
+        <a
+          href="https://clerk.com"
+          target="_blank"
+          rel="noopener noreferrer"
+          className="font-medium hover:text-neutral-600 dark:hover:text-neutral-300"
+        >
+          CLERK
+        </a>
+        .
+      </p>
+    </div>
+  )
 }

package/dist/frameworks/react/add-ons/clerk/info.json

@@ -1,6 +1,6 @@
 {
   "name": "Clerk",
-  "description": "Add Clerk authentication to your application.",
+  "description": "Hosted user accounts with prebuilt sign-in UI and social providers (managed).",
   "phase": "add-on",
   "modes": ["file-router"],
   "type": "add-on",

package/dist/frameworks/react/add-ons/compiler/info.json

@@ -1,7 +1,7 @@
 {
   "name": "Compiler",
   "phase": "setup",
-  "description": "Add React Compiler",
+  "description": "Auto-memoize components and hooks (fewer re-renders, no manual useMemo/useCallback).",
   "link": "https://react.dev/learn/react-compiler",
   "modes": ["code-router", "file-router"],
   "type": "add-on",

package/dist/frameworks/react/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/react/add-ons/drizzle/info.json

@@ -1,6 +1,6 @@
 {
   "name": "Drizzle",
-  "description": "Add Drizzle ORM to your application.",
+  "description": "Type-safe SQL query builder for Postgres, SQLite, or MySQL.",
   "phase": "add-on",
   "type": "add-on",
   "category": "orm",

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