tanstack-cloudflare-template

A template for SSR-ready React applications powered by TanStack Start and Cloudflare Workers.

Tech Stack

• Framework: TanStack Start (React 19)
• Routing: TanStack Router (file-based)
• Styling: Tailwind CSS
• Hosting: Cloudflare Workers
• Build: Vite
• Testing: Vitest + Testing Library
• Lint / Format: oxlint / oxfmt
• Git Hooks: Lefthook
• Package Manager: pnpm

Development

pnpm install        # Install dependencies
pnpm dev            # Start dev server
pnpm build          # Production build
pnpm preview        # Preview production build
pnpm deploy         # Deploy to Cloudflare Workers
pnpm test           # Run tests
pnpm lint           # Run linter
pnpm lint:fix       # Auto-fix lint issues
pnpm fmt            # Check formatting
pnpm fmt:fix        # Auto-fix formatting
pnpm check          # Run lint + format check
pnpm cf-typegen     # Generate Cloudflare bindings types

Project Structure

src/
  routes/         # File-based routing
  router.tsx      # Router configuration
  styles.css      # Global styles
wrangler.jsonc    # Cloudflare Workers config
vite.config.ts    # Vite config