apps/web-tanstack is the React-first ZShip frontend template. It uses TanStack Start for routing, SSR, and server route handlers, then deploys as a Cloudflare Worker.
What ships today
- React 19 UI with TanStack Router file routes
- TanStack Start server handlers under
src/routes/api/** - Cloudflare Worker deployment through
@cloudflare/vite-plugin - Service Binding first backend calls with HTTP fallback for local development
- Manifest-driven app identity through
zship.app.json - Auth, pricing, checkout, dashboard, API keys, check-in, referral, support, blog, docs, and AI playground routes
- Shared locale, theme, Query Client, and markdown rendering providers
- Public SEO surfaces:
sitemap.xml,robots.txt,/llms.txt, and/llms-full.txt
When to choose this frontend
Choose the TanStack template when a project wants React as the primary UI stack and still needs ZShip’s server-side tenant contract, authenticated SaaS flows, and Cloudflare-native deployment.
Main source areas
src/routes/**: public pages, dashboard pages, and server route handlerssrc/lib/server/**: cookie, response, Cloudflare env, proxy, sitemap, and llms utilitiessrc/lib/client/**: auth helpers, i18n, theme, and query providerssrc/lib/content/docs.ts: this built-in documentation catalog (en + zh-CN fields)src/lib/seo.ts: shared title/description/canonical/OG helperszship.app.json: app identity, brand, SEO, analytics, and dashboard feature switches