TanStarter

A production starter template for TanStack Start.

Core Technologies

Frontend

• TanStack
  • Start
  • Router
  • Query -@lukemorales/query-key-factory
  • Form
  • Table
• shadcn/ui UI components with modals and notifications
• Tailwind CSS styling
• Lingui localization
• start-secure Content Security Policy (CSP) with native nonce support
• start-streaming Server-Sent Events (SSE) for real-time streaming
• Service Worker with Serwist

Backend & Data

• Drizzle ORM + PostgreSQL (via Neon)
• Drizzle-valibot schema validation
• Better Auth authentication
• Casl authorization
• React-Email email templates
• Axiom logging integration

Testing & Quality

• Vitest unit testing
• Playwright E2E testing
• Storybook component development and testing
• Rollbar error tracking and release monitoring

Tools

• Docker containerization
• Biome fast linting and formatting
• Fixpack package.json normalization
• Turborepo monorepo management
• LeftHook precommit checks
• envin type-safe environment variable validation

Getting Started

1. Use this template or clone this repository.

2. Install dependencies:

   bun install

3. Create a .env file based on .env.example.

4. Run the development server:

   bun dev

   The development server should be now running at http://localhost:3000.

5. Check out the real-time streaming demo at http://localhost:3000/debug/streaming-sse to see Server-Sent Events in action.

Building for production

1. Configure vite.config.ts for your preferred deployment target. Read the hosting docs for more information.

2. Build the application:

   bun run build

3. If building for Node, you start the application via:

   bun start

Production Readiness Checklist

The following items are still needed for full production readiness:

• SEO configuration
• Bundle Analyzer (couldn't get it to work)

Recently Completed

• Nonce implementation - DONE! Now using native TanStack Start nonce support with strict CSP (see src/start.ts and src/router.tsx)

Future Considerations

• event pipelines - Rudderstack
• AI - Vercel AI SDK
• posthog proxy

Contributing

Please note that this is an opinionated test project used for minimum reproduction of issues and integration testing for a production site using the core technologies. Not all requests and PRs will be accepted.

See Also

• https://github.com/dotnize/tanstarter - Thanks so much for this great starter!
• nekochan0122/tanstack-boilerplate - A batteries-included TanStack Start boilerplate that inspired some patterns in this template
• AlexGaudon/tanstarter-better-auth - Better-auth implementation reference