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

pnpm create mugnavo

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

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

   pnpm create mugnavo

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

3. Push the schema to your database with drizzle-kit:

   pnpm db push

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

4. Run the development server:

   pnpm dev

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

The vite config is currently configured to use Nitro to deploy on Netlify, but supports many other deployment presets like Vercel and Node.

While Nitro provides a great multi-provider default, the official @netlify/vite-plugin-tanstack-start is also available for Netlify deployments.

Refer to the TanStack Start hosting docs for deploying to other platforms.

• 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.

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

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

We use pnpm by default, but you can modify these scripts in package.json to use your preferred package manager.

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

• 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)

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

• TanStack CLI - The official CLI and AI toolkit for TanStack. Create and customize TanStack Start apps, search docs, integrate with AI agents, and more.
• awesome-tanstack-start - A curated list of awesome resources for TanStack Start.
• shadcn/ui Directory, MCP, shoogle.dev - Component directories & registries for shadcn/ui.