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.