Documentation HeartCo Starter
Boilerplate SaaS production-ready pour devs. Next.js 15, tRPC v11, Prisma 7, Supabase, NextAuth v5, Stripe, Mistral AI.
Cette doc s'adresse aux devs acheteurs. Pour la documentation utilisateur final du SaaS livré (end-users du dashboard), voir
apps/web/content/docs/.
Quick start (3 commandes)
pnpm install # installer les dépendances
pnpm setup # prisma generate + migrate + seed
pnpm dev # http://localhost:3000Détails complets : Getting Started.
Sommaire FR
| # | Page | Status | Description |
|---|---|---|---|
| 1 | Getting Started | stable | Installation, configuration, premier lancement |
| 2 | Architecture | stable | Structure du projet, App Router, tRPC, conventions |
| 3 | Authentification | stable | NextAuth v5, providers OAuth, rôles, inscription |
| 4 | Base de données | stable | Prisma 7, multi-tenant, migrations |
| 5 | Modules | stable | 39 modules, navigation, ajouter un module |
| 6 | Permissions | stable | Matrice RBAC, 143 permissions, 7 rôles |
| 7 | Paiements | stable | Stripe, plans EUR/CHF, modules à la carte, freemium |
| 8 | Personnalisation | stable | Branding, Tailwind, emails, recipes |
| 9 | Sécurité | stable | Multi-tenant, IDOR, CSP, rate limit, encryption |
| 10 | Déploiement | stable | Vercel, env vars, 18 crons QStash, domaines |
| 11 | Tests | stable | Vitest, Playwright, écrire un test |
| 12 | FAQ | stable | Questions fréquentes |
Ressources complémentaires
| Fichier | Status | Description |
|---|---|---|
| MOBILE_SETUP.md | stable | Setup app terrain Expo (Tier Pro) |
| VIBE_CODING_GUIDE.md | stable (EN) | 17 prompts Claude Code & Cursor |
| deployment/vercel-env-checklist.md | stable | Checklist variables Vercel détaillée |
English documentation
La traduction anglaise complète est disponible à /docs/en : toutes les pages ci-dessus ont leur équivalent anglais. Utilisez le sélecteur FR/EN dans l'en-tête des pages de documentation pour basculer en conservant la page courante.
Stack technique
- 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)
- Paiements : Stripe (abonnements EUR/CHF, modules, webhooks)
- IA : Mistral AI (copilote, génération, analyse)
- UI : Tailwind v4 + Radix UI (shadcn/ui)
- Temps réel : Pusher Channels
- Emails : Resend
- Cache : Upstash Redis
- Crons : Upstash QStash (18 schedules)
- Package manager : pnpm 9 (obligatoire)
- Node : 22+
Pour commencer
Rendez-vous sur Getting Started pour installer et lancer le projet en 5 minutes.