Introduction
What Is TanShip
TanShip is a production-ready TanStack Start template for building modern web applications. It gives you authentication, payments, internationalization, a polished dashboard, and a public landing page — all wired together and ready to deploy on Cloudflare Workers.
The goal is simple: skip the boilerplate. Instead of spending weeks setting up routing, theming, forms, auth, and a dozen other fundamentals, you start with a working application and focus on what makes your product unique.
TanShip is free, open source, and built entirely on community-maintained libraries.
Tech Stack
A quick tour of what's inside:
- React 19 + TanStack Start + Vite — Modern frontend with file-based routing. See Pages & Routing.
- shadcn/ui + Tailwind CSS v4 — Component primitives and utility-first styling. See Components and Theme Customizer.
- Cloudflare Workers — Serverless edge runtime. See Deploy to Cloudflare.
- D1 + Drizzle ORM — Type-safe database queries at the edge. See Database.
- Better Auth — OAuth and credential-based authentication. See Authentication.
- Creem / Stripe / PayPal — Selectable payment provider with subscriptions and one-time purchases. See Payment Overview.
- EN / ZH URL-based i18n — Locale switching without cookies or browser detection. See Internationalization.
- Resend — Transactional email delivery for auth, newsletter, and contact. See Email, Newsletter, and Contact Form.
- Cloudflare Workers AI — Text generation, summarization, and translation tools. See AI.
Who It's For
- Developers launching a SaaS product who want to skip the blank canvas.
- Teams building internal tools or admin dashboards.
- Developers evaluating the TanStack Start + Cloudflare Workers stack.
- Anyone who wants a realistic, working starting point instead of a "hello world."
How to Use These Guides
The sidebar on the left organizes every guide into six groups. Reading them in order works best — each article builds on the ones before it.
| Group | What You'll Learn | Start With |
|---|---|---|
| Start Here | Install, run, and configure the project | Getting Started |
| Configuration | Tweak app settings and feature flags | App Configuration |
| Deployment | Ship to Cloudflare Workers | Deploy to Cloudflare |
| Integrations | Database, auth, email, payments, AI, newsletter, contact form | Database |
| Customization | Pages, components, theming, navigation, i18n, blog, changelog, SEO | Pages & Routing |
| Codebase | Architecture, TypeScript, formatting, primitives, testing | Project Structure |
When you're ready, head to Getting Started to set up the project on your machine.