start-pro

A modern, production-ready React starter template powered by TanStack Start, Vite, and Tailwind CSS v4.

Features

• Framework: TanStack Start for SSR and routing.
• Routing: virtual-next-routes for Next.js-like file-system routing with TanStack Router.
• Styling: Tailwind CSS v4 with shadcn/ui components.
• Database: Drizzle ORM with PostgreSQL.
• Authentication: Better Auth.
• Tooling: Biome/ESLint, Prettier, and commit hooks.

.
├── layout.tsx
├── page.tsx
├── (dashboard)
│   ├── layout.tsx
│   └── x
│       └── page.tsx
└── api
    └── auth
        └── [...all]
            └── route.ts

Getting Started

Prerequisites

• Bun (recommended) or Node.js

Installation

• Clone the repository:

git clone <repository-url>
   cd start-pro

• Install dependencies:

bun install

• Set up environment variables:

cp .example.env .env

Update .env with your database credentials and other secrets.

• Push the database schema:

bun run db:push

• Start the development server:

bun run dev

Scripts

• dev: Start the development server on port 3000.
• build: Build the application for production.
• start: Preview the production build.
• db:push: Push schema changes to the database.
• db:studio: Open Drizzle Studio to manage your database.
• lint: Run linting checks.

Virtual Next Routes

This project utilizes virtual-next-routes to provide a familiar Next.js-style file-system routing experience while leveraging the power of TanStack Router. This allows for defining routes using the app directory structure (e.g., app/page.tsx, app/api/route.ts).