@tanstack/create 0.64.0 → 0.65.0

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

@@ -27,7 +27,7 @@ export async function setupIntent(
       resolve(targetDir),
       options.packageManager,
       '@tanstack/intent',
-      ['install'],
+      ['install', '--map'],
     )
     environment.finishStep('setup-intent', 'TanStack Intent configured')
     s.stop('TanStack Intent configured')

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)
+  })
 })