What's included in TanStarter
A walkthrough of every feature that ships with TanStarter.
TanStarter is a SaaS starter kit. You get a working app with AI capabilities, auth, payments, file storage, email, analytics, and more — all configured and connected. Here's what ships in the box.
1. AI
TanStarter ships with a full AI playground powered by TanStack AI, Cloudflare Workers AI, and fal.ai adapters.
- AI Text Processing — Summarize long articles with BART or translate text across 10 languages with M2M100, all via Cloudflare Workers AI REST API.
- AI Chat — Generate creative taglines with Llama 3.1 via Cloudflare Workers AI chat API, and create text-to-speech with Deepgram Aura (12 voices).
- AI Image Generation — Generate images with Cloudflare Workers AI (Flux, SDXL, DreamShaper) or fal.ai (Gemini, Flux, GPT Image 2) via @tanstack/ai fal adapter.
- AI Image Editing — Edit images with fal.ai Gemini 2.5 Flash — upload a portrait and apply styles like Bobblehead Caricature, Pixar 3D, or Anime Portrait.
2. Authentication
Built on Better Auth, the most popular open source authentication library.
- Email/Password — Register and login with email/password, with optional email verification required to login.
- Social Login — Login with Google. Easily add more providers like Twitter, Apple, Facebook, etc.
- Reset Password — Users can reset password if they forget it. Social login users can also set a password to login with email.
- User Profile — Manage account information including name, password, and avatar.
- Role-Based Access — Admin and user roles with route-level middleware that blocks unauthenticated or non-admin users.
3. Payments
Stripe, Creem, or Waffo handles all payment flows.
- Subscriptions & One-Time Payments — Monthly, yearly, or lifetime plans. Free trials are supported.
- Pricing Configuration — Configure the pricing table including price, name, description, interval, features and limits.
- Billing Management — Users manage billing through the Stripe Customer Portal, Creem portal, or Waffo consumer portal — payment methods and billing history included.
- Webhook Handling — Payment events are pre-wired. WeChat Pay and Alipay work too if enabled in Stripe's dashboard.
4. Pages
TanStarter comes with many built-in, ready-to-use pages. Edit the Markdown files directly or configure via a single config file.
- Landing Page — High-conversion landing page with 12+ marketing blocks (hero, logo cloud, stats, features, CTA, integrations, pricing, FAQ, testimonials, newsletter). Rearrange or remove sections by editing one file.
- Blog Pages — MDX-based blog system with listing, post, and category pages via Content Collections. Drop Markdown files into
content/blog/and they show up automatically. - Pricing Page — Pricing table and FAQ section, fully configurable via a single config file.
- About Page — Simple and beautiful about page with introduction.
- Contact Page — Functional contact form that sends messages via email.
- Legal Pages — Privacy Policy, Terms of Service, and Cookie Policy — just edit the Markdown files.
5. Localization
TanStarter now ships with multilingual support built in.
- English and Chinese by Default — UI copy is managed through Paraglide and Inlang, with translations stored in
project.inlang/messages/. - Locale-Aware Routing — The base locale keeps clean URLs, while Chinese pages use the
/zhprefix. Navbar, footer, auth pages, dashboard, admin pages, settings, pricing, and marketing pages all read from the active locale. - Localized SEO — Canonical URLs, sitemap entries,
hreflangalternates, Open Graph locale tags, and<html lang>are generated from the current locale. - Localized Payments — Checkout and billing portal flows pass the active locale to Stripe when available, so payment pages can match the user's language.
6. Email & Newsletter
- Cloudflare Email Service — Routing Rules forwards inbound emails without exposing personal addresses. Useful for support aliases like
support@yourdomain.com. - Resend — Handles outbound transactional emails (welcome emails, password resets, etc.) via React Email templates. Preview locally with
pnpm email:dev. - Newsletter — Resend Audiences or Beehiiv backs subscribe/unsubscribe endpoints. Auto-subscribe new users on registration if you turn that on.
7. File Storage
- Cloudflare R2 — Upload, download, and delete files. Files are organized in per-user folders. Set limits on file size and allowed types. No egress fees.
- No S3 Keys — Files are accessed through Wrangler bindings — no API keys to manage.
8. Cache
- Cloudflare KV Cache — The template includes optional KV-backed caching for read-heavy data such as newsletter status checks, public lists, and repeated API responses.
- Lower Provider Load — Cacheable reads can be reused at the edge, while critical state still belongs to the database, auth system, or payment provider.
9. SaaS Features
- Waitlist — Built-in waitlist page to collect leads before launch.
- Notifications — Payment events can trigger Discord or Feishu webhook notifications.
- Live Chat — Add Crisp live chat to your site by setting one environment variable.
10. Batteries Included
- Customizable Themes — Support for customizable themes via generators like Tweakcn.
- Multiple Analytics — Google Analytics, Plausible, Umami, and Microsoft Clarity. Set the environment variables for whichever ones you want, and they activate automatically in production.
- SEO Optimized — Per-page metadata via a
seo()helper. Open Graph tags, Twitter Cards, canonical URLs, and favicon support. Sitemap and OG metadata are auto-generated.
11. Admin Dashboard
- User Management — Search, filter, and paginate users.
- Role & Access Control — Assign roles, ban or unban accounts (with reason and expiration).
- API Keys — Manage API keys from a dedicated admin interface.
12. Tech Stack
TanStarter is built on a modern, cost-effective tech stack running entirely on Cloudflare's edge network.
- TanStack Start — Full-stack React framework with file-based routing via TanStack Router and server-state management via TanStack Query.
- Cloudflare D1 — Serverless SQLite database that runs at the edge. Drizzle ORM sits on top for type-safe queries, schema migrations, and a visual studio.
- Cloudflare R2 — S3-compatible object storage with zero egress fees. Files are accessed through Wrangler bindings — no S3 API keys to manage.
- Cloudflare KV — Optional edge cache for read-heavy server data.
- Cloudflare Workers — Deploy your app to the edge. The compiled template is around 2 MB, fitting on the free plan. Run
pnpm deployand you're live. - Cloudflare Email Service — Zero-cost email service running on Cloudflare Workers for transactional emails.
- Cloudflare Workers AI — Run AI models (Flux, SDXL, Llama 3.1, etc.) at the edge via REST API.
Every module is optional. Turn off what you don't need, keep what you do, and focus on the parts that make your product different.