TanStarter

A minimal starter template for 🏝️ TanStack Start. → Preview here

bun create mugnavo

• React 19 + React Compiler
• TanStack Start + Router + Query
• Tailwind CSS + shadcn/ui + Base UI (base-maia)
• Vite 8 + Nitro v3
• Drizzle ORM + PostgreSQL
• Better Auth
• Oxlint + Oxfmt

Tip

This template is also available as a monorepo, powered by Vite+ and pnpm. See mugnavo/tanstarter-plus.

Getting Started

1. Use this template or create a project using our CLI:

   bun create mugnavo

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

3. Generate the initial migration with drizzle-kit, then apply to your database:

   bun run db generate
   bun run db migrate

   https://orm.drizzle.team/docs/migrations

4. Run the development server:

   bun run dev

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

Deploying to production

The vite config is configured to use Nitro by default, which supports many deployment presets like Netlify, Vercel, Node.js, and more.

Refer to the TanStack Start hosting docs for more information.

Issue watchlist

• Router/Start issues - TanStack Start is in RC.
• Devtools releases - TanStack Devtools is in alpha and may still have breaking changes.
• Nitro v3 beta - The template is configured with Nitro v3 beta by default.

Goodies

Git hooks

We use Husky to run git hooks with the following tools:

• lint-staged - Run Oxfmt to format staged files on commit (pre-commit).

Scripts

We use Bun as the package manager and runtime for CLI tooling (bun, bunx).

• auth:generate - Regenerate the auth db schema if you've made changes to your Better Auth config.
• db - Run drizzle-kit commands. (e.g. bun run db generate, bun run db studio)
• ui - The shadcn/ui CLI. (e.g. bun run ui add button)
• format, lint - Run Oxfmt and Oxlint, or both via bun run check.
• deps - Selectively upgrade dependencies via taze.

Utilities

• auth/middleware.ts - Sample middleware for forcing authentication on server functions. (see #5 and #17)
• theme-toggle.tsx, theme-provider.tsx - A theme toggle and provider for toggling between light and dark mode. (#7)

License

Code in this template is public domain via Unlicense. Feel free to remove or replace for your own project.

Ecosystem

• @tanstack/intent - Up-to-date skills for your AI agents, auto-synchronized from your installed dependencies.
• awesome-tanstack-start - A curated list of awesome resources for TanStack Start.
• shadcn/ui Directory, MCP, shoogle.dev - Component directories & registries for shadcn/ui.