Tu as des idées. Ça fait des mois qu'elles traînent. Elles végètent dans ton app de notes, fermentant lentement en culpabilité. Chaque lundi tu te dis ' le week-end prochain ' et chaque dimanche soir tu as mystérieusement réorganisé ton bureau au lieu de livrer quoi que ce soit.

Le problème, c'est ni le talent ni les outils. C'est le process. La plupart des projets du week-end meurent parce que les builders passent le samedi à prendre des décisions qu'ils auraient dû prendre vendredi, et le dimanche à peaufiner des trucs que personne n'a demandés. 🔍

Il y a six mois, ce guide n'aurait pas été réaliste. Claude Code ne savait pas scaffolder une app full-stack à partir d'un seul fichier de spec. Le free tier de Supabase n'incluait pas les edge functions. Le plan hobby de Vercel avait des limites de déploiement plus serrées. Mais fin mars 2026, chaque outil de ce playbook tourne sur un free tier assez généreux pour livrer un vrai produit — pas une démo jouet. Le coût d'un MVP de week-end est passé de ' quelques centaines d'euros en hébergement et APIs ' à ' littéralement zéro euro si tu fais gaffe '. C'est la fenêtre de tir. 💰

Voici le playbook que j'ai reverse-engineeré en observant des centaines de lancements de week-end cette dernière année — ceux qui ont réellement produit une URL live avec de vrais utilisateurs le dimanche soir. Pas un prototype. Pas une maquette Figma. Un produit déployé. L'arme secrète : Claude Code — l'assistant de code IA d'Anthropic, basé terminal, qui lit ton projet, écrit du code et exécute des commandes directement dans ta codebase.

Vendredi soir : une heure de décisions (pas de code)

Le week-end commence vendredi à 21h. Pas avec du code — avec des décisions. Chaque minute que tu passes à hésiter samedi, c'est une minute où tu ne construis pas.

Choisis une forme de projet

Voici les seules formes qui peuvent réalistement être livrées en un week-end :

Forme Exemple Complexité
Outil Fusion de PDF, compresseur d'images, formateur de texte Basse
Dashboard Visualiseur analytics, page de statut, affichage de métriques Moyenne
Marketplace light Annuaire, site de listings, collection curatée Moyenne
Micro SaaS Un produit à une seule feature avec auth et page de facturation Moyenne-Haute
API wrapper Prendre une API moche — une interface pour que les programmes communiquent entre eux — et la rendre jolie Basse-Moyenne

Rédige la spec d'une page

Ouvre un fichier. Écris exactement ça. Rien de plus :

# Weekend MVP : [Nom]

## Une phrase
[Ce que ça fait, pour qui]

## Parcours principal
1. L'utilisateur arrive sur la page
2. L'utilisateur fait [action principale]
3. L'utilisateur obtient [résultat]

## Indispensable (samedi)
- [ ] Landing page
- [ ] Feature principale
- [ ] Déployer sur une URL de production

## Bonus (dimanche)
- [ ] Auth
- [ ] Notifications par email
- [ ] Analytics basiques

## On ne construira PAS
- [ ] Panel admin
- [ ] Système de paiement
- [ ] App mobile
- [ ] Profils utilisateurs

Cette section ' On ne construira PAS ' ? La partie la plus importante de tout le doc. C'est ton bouclier contre le scope creep — cette tendance naturelle à ajouter ' juste un truc de plus ' jusqu'à ce que le dimanche soit passé et que tu n'aies rien construit de complet.

Initialise le repo

Un repo (dépôt) est simplement un dossier de projet suivi par Git — un logiciel de versioning qui sauvegarde chaque modification que tu fais, comme un Ctrl+Z infini pour ton code.

mkdir my-mvp && cd my-mvp
git init

# Choisis UN stack. Ne délibère pas.
# Option A : Next.js + Supabase (full-stack, le plus flexible)
npx create-next-app@latest . --typescript --tailwind --app

# Option B : Statique + API (plus simple, plus rapide)
# Crée juste un index.html et un dossier /api

touch SPEC.md  # Colle ta spec d'une page ici
git add -A && git commit -m "init: weekend mvp"

Next.js est un framework basé sur React — pense à un kit de démarrage pour construire des apps web qui gère le routing, le rendu côté serveur et le déploiement clé en main. Supabase te donne une base de données, un système de login et du stockage de fichiers sans aucune config serveur.

Samedi matin : construire le cœur (4-5 heures)

Réveil. Café. Terminal ouvert. Pas de réseaux sociaux, pas de mails, pas de ' je vérifie juste un truc '.

Heures 1-2 : Scaffolder avec Claude Code

C'est là que Claude Code justifie son existence. Ouvre-le dans le répertoire de ton projet :

claude

Donne-lui tout le contexte :

Lis SPEC.md. C'est un MVP de week-end — on construit
le produit minimum possible.

Scaffolde le projet :
1. Mets en place la structure des pages selon le parcours principal
2. Crée le composant de la feature principale
3. Configure le styling basique avec Tailwind
4. Crée un layout avec nav et footer
5. Pas d'auth pour l'instant, pas de base de données — juste l'UI et la logique principale

Claude Code génère 5 à 15 fichiers. Ne relis pas chaque ligne. Tu vérifies trois choses : est-ce que ça tourne (npm run dev), est-ce que le parcours principal est là, est-ce que la structure du code est saine ?

Heures 2-4 : Implémenter la feature principale

C'est le seul code qui compte. Tout le reste, c'est du scaffolding — du support structurel qui n'est pas le produit lui-même.

Disons que tu construis un calculateur de coût de réunion. Tu dis à Claude Code :

La feature principale est un calculateur qui prend :
- Le nombre de participants
- Le taux horaire moyen
- La durée de la réunion

Et affiche un compteur de coût en temps réel, le coût total
et le détail coût-par-minute. Un seul composant React.
Pas de backend nécessaire. Utilise useState pour le timer,
useEffect pour l'animation du compteur.

Claude Code l'écrit. Tu testes dans le navigateur. Tu itères :

L'animation du compteur saccade. Utilise requestAnimationFrame
au lieu de setInterval. Mets le chiffre du coût en énorme — 72px,
font monospace.

Discipline clé : itère uniquement sur la feature principale. Si la nav est bizarre, note-le. Les retouches cosmétiques, c'est dimanche.

Heures 4-5 : Déployer 🚀

Déploie avant le déjeuner. Avoir une URL live — une vraie adresse que n'importe qui peut visiter — change ta psychologie de ' je bidouille du code ' à ' je construis un produit '.

# Vercel (le plus rapide pour Next.js)
npx vercel

# Ou Cloudflare Pages (le plus rapide pour les sites statiques)
npx wrangler pages deploy ./out

Vercel auto-déploie à chaque push de code. Le free tier couvre n'importe quel MVP. Envoie l'URL à une personne. Sa réaction de 30 secondes t'en dit plus qu'une semaine de développement en solo.

Déjeuner : décroche

Sérieusement. Mange un truc qui n'est pas devant ton écran. La session de l'après-midi sera deux fois plus productive quand ton cerveau aura eu une pause.

Samedi après-midi : le ciment (3-4 heures)

La feature principale fonctionne. Maintenant, fais en sorte que ça ressemble à un produit.

Heures 6-7 : Base de données (si nécessaire)

Pas tous les MVP ont besoin d'une base de données — un endroit structuré pour stocker et retrouver des données. Un calculateur, non. Un annuaire, oui.

Si le tien en a besoin, dis à Claude Code :

Configure Supabase :
1. Conçois le schéma minimum — uniquement les tables pour le parcours principal
2. Configure le client dans lib/supabase.ts
3. Ajoute un CRUD basique pour le type de données principal
4. Pas de RLS pour l'instant, pas de requêtes complexes — fais juste en sorte que ça marche

CRUD signifie Create, Read, Update, Delete — les quatre opérations de base sur n'importe quelle donnée. RLS (Row Level Security) contrôle qui peut voir quelles lignes. On s'en occupe plus tard.

Le free tier de Supabase te donne 500 Mo de PostgreSQL — une base de données open-source puissante. Pour un MVP, tu utiliseras environ 1 Mo. Ça fait 500 MVP de marge. 💰

// lib/supabase.ts — c'est tout ce qu'il te faut
import { createClient } from '@supabase/supabase-js'

export const supabase = createClient(
  process.env.NEXT_PUBLIC_SUPABASE_URL!,
  process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY!
)

Heures 7-8 : Auth (si nécessaire)

L'auth (authentification) — faire en sorte que les utilisateurs se connectent pour s'identifier. Un calculateur de réunion n'en a pas besoin. Un dashboard personnel, oui.

Ajoute Supabase Auth :
1. Inscription/connexion par email + mot de passe
2. Composant formulaire d'auth simple
3. Route protégée pour le dashboard
4. Gestion de session via middleware
5. Pas de social login, pas de MFA — juste email et mot de passe

Le MFA (authentification multi-facteurs) c'est ce deuxième code envoyé sur ton téléphone. Supabase Auth gère 50 000 utilisateurs actifs mensuels gratuitement. Tu n'atteindras jamais ce seuil pendant un week-end MVP.

Heures 8-9 : Landing page

Ta landing page a besoin d'exactement quatre choses :

  1. Titre — ce que ça fait (5-8 mots)
  2. Sous-titre — pour qui c'est (1 phrase)
  3. Bouton CTA — ' Essaie gratuitement ' / ' Commence maintenant '
  4. Une capture d'écran — montre le produit en action
Crée une landing page :
- Section hero avec titre, sous-titre et CTA
- Une section montrant la feature principale
- Footer simple avec infos de contact
- Pas de témoignages, pas de pricing, mobile responsive

Pas de tableau comparatif de features. Pas de logos ' ils nous font confiance '. Pas de dégradés animés. Livre le vrai produit, pas un site marketing qui parle du vrai produit.

Dimanche : peaufinage et lancement (6-8 heures)

Matin : corrige tout ce que tu as ignoré ⚡

Ouvre tes notes de samedi. Envoie-les à Claude Code en batch :

Corrige dans cet ordre :
1. La nav ne surligne pas la page active
2. Le menu mobile ne se ferme pas quand on clique un lien
3. L'état de chargement affiche du vide — ajoute un skeleton
4. La validation du formulaire manque sur le champ email
5. Les liens du footer ne mènent nulle part — ajoute des pages ou supprime les liens

Chaque fix est petit. Ensemble, ils transforment une ' démo ' en ' produit '.

Après-midi : checklist de lancement

### Ça marche
- [ ] La feature principale fonctionne sur Chrome desktop
- [ ] La feature principale fonctionne sur Safari mobile
- [ ] Tous les liens mènent quelque part
- [ ] Les formulaires valident les saisies
- [ ] Les erreurs affichent des messages compréhensibles

### C'est présentable
- [ ] Le favicon existe
- [ ] Le titre de page et la meta description sont définis
- [ ] L'image OG pour le partage social est là
- [ ] Pas de texte placeholder (' Lorem ipsum ')
- [ ] Espacement et typographie cohérents

### Prêt pour la prod
- [ ] Variables d'environnement configurées en production
- [ ] HTTPS fonctionne
- [ ] Temps de chargement sous 3 secondes
- [ ] Pas d'erreurs dans la console
- [ ] Page 404 existante

Demande à Claude Code : ' Passe cette checklist sur notre codebase. Dis-moi ce qui passe, ce qui échoue, corrige les échecs. ' Il gère ça en quelques minutes.

Soir : envoie la sauce

Poste sur Twitter/X, les serveurs Discord pertinents, un thread Reddit, Hacker News ' Show HN ' si ça colle. Le format de post qui marche :

J'ai construit [nom du produit] ce week-end — ça [fait un truc] pour [audience]. [URL] Construit avec Next.js + Supabase + Claude Code. Vos retours sont les bienvenus.

N'écris pas une dissertation de 2000 mots pour un projet de week-end. Le produit parle ou il ne parle pas.

Les pièges qui détruisent les MVP de week-end 🗑️

Piège Pourquoi c'est tentant Pourquoi c'est un piège
Design system custom ' Ça doit avoir l'air pro ' Les defaults de Tailwind sont très bien
Auth from scratch ' Je fais pas confiance aux tiers ' Supabase Auth prend 10 minutes
Optimisation de la BDD ' Et si ça scale ? ' Tu as 0 utilisateurs. Optimise à 1 000
Pipeline CI/CD ' Les bonnes pratiques ' Push sur main. Vercel auto-déploie
Suite de tests ' Il faudrait des tests ' Teste manuellement un MVP de week-end
Intégration paiement ' Il faut monétiser ' Trouve des utilisateurs d'abord. Stripe en semaine 2
Panel admin ' Il faut gérer les données ' Utilise le dashboard Supabase directement

CI/CD (Continuous Integration/Continuous Deployment) signifie tests automatisés et déploiement à chaque push de code. Précieux au bon moment. Ce week-end n'est pas ce moment.

Le planning réaliste

Vendredi 21h :   Rédiger la spec, initialiser le repo        (1h)
Samedi 9h :      Scaffolding + feature principale             (4h)
Samedi 13h :     Pause déjeuner                               (1h)
Samedi 14h :     BDD + auth + landing page                    (4h)
Samedi 20h :     Terminé pour la journée
Dimanche 10h :   Peaufinage + corrections de bugs              (3h)
Dimanche 14h :   Checklist de lancement + déploiement          (2h)
Dimanche 17h :   Post en ligne + collecte de retours           (1h)
Dimanche 18h :   MVP du week-end livré

Temps de code total concentré :                               ~14h

14 heures de travail concentré. Pas 48 heures de nuit blanche chaotique. Dors les deux nuits. Fais du sport dimanche matin. Du code reposé bat du code épuisé, à chaque fois.

🦝 Le mot de Schnapps

Le MVP de week-end stress-teste ton idée, pas ton endurance. Si tu ne peux pas expliquer ce que fait le produit en une phrase, tu ne peux pas le construire en un week-end. Si tu ne peux pas construire la feature principale en 4 heures avec Claude Code en renfort, la feature est trop complexe pour un MVP.

Les projets qui livrent ont un point commun : le builder a taillé dans le scope sans pitié. Une seule section sur la landing page. Une feature dans l'app. Deux tables dans la base de données. Et c'est livré.

Les projets qui ne livrent pas ont un autre point commun : le builder a passé le samedi après-midi à chercher quelle bibliothèque d'animation utiliser pour les transitions de page. Il n'y a pas de transitions de page dans un MVP. Il y a une page, et elle marche. Livre ça. 🚀