TanStack Start Template

A modern full-stack template with TanStack Start, React, Prisma, and PostgreSQL.

🚀 Quick Start

Using the Template

# Clone the template
npx degit MatthewSaintBull/TanstackStartTemplateEmpty my-app
cd my-app

# Run the automated setup (installs everything and starts Docker)
# macOS/Linux:
npm run setup

# Windows:
setup.bat

That's it! 🎉 The setup script will:

• ✅ Install all dependencies
• ✅ Configure environment variables
• ✅ Start Docker containers with PostgreSQL
• ✅ Set up Prisma
• ✅ Open your app at http://localhost:3000

Manual Setup (Alternative)

If you prefer to set things up manually:

npm install
npm run docker:up

Visit http://localhost:3000

📖 Detailed Installation Guide - Step-by-step setup and troubleshooting

📖 Full Docker Guide

Option 2: Local Development

1. Set up your PostgreSQL database
2. Update .env with your database URL
3. Run migrations:

   npx prisma migrate dev
   npx prisma generate

4. Start dev server:

   npm run dev

📚 Documentation

• Docker Setup Guide - Complete Docker Compose setup with hot reload
• Prisma + Docker Guide - Running migrations and managing your database in Docker
• TanStack Start Docs - Learn more about TanStack Start

🛠️ Tech Stack

• Framework: TanStack Start
• UI: React 19
• Styling: Tailwind CSS 4
• Database: PostgreSQL (via Docker)
• ORM: Prisma 7
• Build Tool: Vite 7

📦 Available Scripts

Script	Description
npm run setup	🚀 Complete automated setup
npm run dev	Start development server
npm run build	Build for production
npm run docker:up	Start Docker containers
npm run docker:down	Stop Docker containers
npm run docker:logs	View application logs
npm run docker:rebuild	Rebuild containers
npm run docker:clean	Remove containers and volumes

🔥 Features

✅ Hot reload in Docker (no rebuilds needed!)
✅ PostgreSQL with Docker Compose
✅ Prisma ORM with auto-migrations
✅ TypeScript throughout
✅ Tailwind CSS 4
✅ File-based routing with TanStack Router

🗄️ Database

After building your Prisma schemas in prisma/schema.prisma:

# With Docker (recommended)
docker exec -it tanstack-app npx prisma migrate dev --name init

# Local development
npx prisma generate
npx prisma migrate dev

📝 License

MIT

👤 Author

Matteo Santoro (@MatthewSaintbull)