deployment

Configure TanStack Start deployment, SSR modes, prerendering, and SEO for hosting providers.

Updated May 26, 2026
One-click install
npx skills add https://github.com/Albo-Club/albo-os --skill deployment-albo-club
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: deployment
Source: https://github.com/Albo-Club/albo-os/tree/main/.agents/skills/tanstack-start-core/deployment
Command: npx skills add https://github.com/Albo-Club/albo-os --skill deployment-albo-club

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Deploying a TanStack Start application requires provider-specific configuration, correct SSR behavior per route, and proper SEO metadata, and mistakes in any of these cause runtime failures or poor search visibility. ## Core Features & Use Cases - Multi-Provider Hosting Setup: Configure deployment to Cloudflare Workers, Netlify, Vercel, Node.js/Docker, Bun, and Railway via Vite and Nitro plugins. - Selective SSR and Prerendering: Control server rendering per route with ssr true, false, or data-only, and generate static HTML at build time with crawlLinks. - SEO and Head Management: Define meta tags, Open Graph data, JSON-LD structured data, and dynamic sitemaps via server routes. - Use Case: Deploy a SaaS marketing site to Cloudflare Workers with static prerendering for landing pages, ssr: false for the dashboard, and a dynamic sitemap.xml generated from your posts. ## Quick Start Configure my TanStack Start app to deploy to Cloudflare Workers with prerendering enabled and per-route SSR settings.

Frequently Asked Questions about deployment

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I deploy a TanStack Start app to Cloudflare Workers?▼

Install @cloudflare/vite-plugin and wrangler, add the cloudflare plugin before tanstackStart in vite.config.ts, and create a wrangler.jsonc with the nodejs_compat compatibility flag. Deploy with npx wrangler login followed by pnpm run deploy.

How to disable SSR for specific routes in TanStack Start?▼

Set ssr: false on the route definition to run loaders and render the component only on the client. Use ssr: 'data-only' to run loaders on the server while rendering the component on the client, or pass a function for runtime decisions.

Does TanStack Start support static prerendering?▼

Yes, enable prerender in the tanstackStart Vite plugin config with enabled: true and crawlLinks: true to generate static HTML at build time. Dynamic routes require crawlLinks or an explicit pages configuration to be discovered.

Why is process.env undefined in Cloudflare Workers deployment?▼

Cloudflare Workers inject environment variables per request, so process.env at module scope evaluates to undefined. Import env from cloudflare:workers or read process.env inside handler or middleware server functions instead.

Can I deploy TanStack Start with Bun and React 18?▼

No, Bun deployment requires React 19 via the nitro bun preset. For React 18 projects, use the standard Node.js deployment target instead.

Why is my child route SSR setting being ignored?▼

Child routes inherit parent SSR config and can only be more restrictive, not less. A child cannot upgrade from a parent's ssr: false to ssr: true; the parent's stricter setting always wins.