HeartCo Starter Documentation
Production-ready SaaS boilerplate for developers. Next.js 15, tRPC v11, Prisma 7, Supabase, NextAuth v5, Stripe, Mistral AI.
This documentation is aimed at the developers who buy the boilerplate. For the end-user documentation of the delivered SaaS (dashboard end-users), see
apps/web/content/docs/.
Quick start (3 commands)
pnpm install # install dependencies
pnpm setup # prisma generate + migrate + seed
pnpm dev # http://localhost:3000Full details: Getting Started.
Contents
| # | Page | Status | Description |
|---|---|---|---|
| 1 | Getting Started | stable | Installation, configuration, first run |
| 2 | Architecture | stable | Project structure, App Router, tRPC, conventions |
| 3 | Authentication | stable | NextAuth v5, OAuth providers, roles, sign-up |
| 4 | Database | stable | Prisma 7, multi-tenant, migrations |
| 5 | Modules | stable | 39 modules, navigation, adding a module |
| 5a | Adding a module | stable | Full module scaffold in 9 steps |
| 6 | Permissions | stable | RBAC matrix, 143 permissions, 7 roles |
| 7 | Payments | stable | Stripe, EUR/CHF plans, à-la-carte modules, freemium |
| 8 | Customization | stable | Branding, Tailwind, emails, recipes |
| 9 | Security | stable | Multi-tenant, IDOR, CSP, rate limit, encryption |
| 10 | Deployment | stable | Vercel, env vars, 18 QStash crons, domains |
| 11 | Testing | stable | Vitest, Playwright, writing a test |
| 12 | FAQ | stable | Frequently asked questions |
Additional resources
| File | Status | Description |
|---|---|---|
| Skills | stable | Claude Code skills and slash commands |
| MOBILE_SETUP.md | stable | Expo field-app setup (Pro tier) |
| VIBE_CODING_GUIDE.md | stable | 17 Claude Code & Cursor prompts |
Reading in French? Switch to the French documentation with the FR/EN toggle in the header.
Tech stack
- Framework: Next.js 15 (App Router, Turbopack)
- API: tRPC v11 (76 routers, end-to-end typesafe)
- ORM: Prisma 7 (PostgreSQL via Supabase)
- Auth: NextAuth v5 (Google, Microsoft, Credentials)
- Payments: Stripe (EUR/CHF subscriptions, modules, webhooks)
- AI: Mistral AI (copilot, generation, analysis)
- UI: Tailwind v4 + Radix UI (shadcn/ui)
- Realtime: Pusher Channels
- Emails: Resend
- Cache: Upstash Redis
- Crons: Upstash QStash (18 schedules)
- Package manager: pnpm 9 (mandatory)
- Node: 22+
Getting started
Head over to Getting Started to install and run the project in 5 minutes.