Ta version de travail, et celle du public.
Ton site existe en plusieurs exemplaires. Tu travailles sur le tien, tranquillement, et le public ne voit le résultat qu'une fois que tu l'as validé.
Le trajet d'une modification
- LocalTon ordinateurVisible par toi seule
- GitHubLa sauvegardeGarde chaque version
- ProductionTon vrai siteVisible par tout le monde
Une modification part toujours de ton ordinateur. Quand tu la valides, elle est sauvegardée sur GitHub, et Vercel met aussitôt le vrai site à jour.
Local et production
| Local | Production | |
|---|---|---|
| Adresse | localhost:3000 | Ton nom de domaine |
| Qui le voit | Toi, sur ton ordinateur | Tout le monde |
| Mis à jour | Instantanément, à chaque modification | Quand tu dis à Claude de mettre en ligne |
| Base de données | La même pour les deux : les vraies données | |
| Usage | Construire, ajuster, vérifier | Accueillir tes visiteurs |
Travailler en local
Le site tourne sur ton ordinateur pendant que tu travailles. Chaque modification s'affiche dès que tu recharges la page. Rien n'est visible en ligne.
- Démarrer
Lance le site en local
Claude démarre le site et te donne le lien
http://localhost:3000.- Voir une modification
- Recharge la page dans ton navigateur. Si rien ne change, demande à Claude de relancer le site.
- Arrêter
Arrête le site local
Ou ferme simplement Orca. Ça n'a aucun effet sur le site en ligne.
Mettre en ligne
- Tu vérifies le résultat en local, et tu ajustes jusqu'à ce qu'il te plaise.
- C'est bon, mets en ligne
- Claude vérifie que le site se construit sans erreur, enregistre la modification et l'envoie sur GitHub.
- Vercel met le site public à jour automatiquement, en une à deux minutes.
Le bon réflexe
Après chaque mise en ligne, ouvre ton vrai site sur ton téléphone pour vérifier que tout s'affiche bien.
La base de données
Contrairement au code, la base de données n'existe qu'en un seul exemplaire. Le site local et le vrai site lisent et écrivent dans la même base Supabase.
Les données sont toujours les vraies
Un contact ajouté en testant le formulaire en local apparaît dans ta vraie base. Une donnée supprimée en local est supprimée pour de bon. Teste avec des données reconnaissables (un nom comme « Test Claude ») et demande à Claude de les effacer ensuite.
Les migrations
Quand la structure de la base change (une nouvelle table, un nouveau champ dans un formulaire), Claude écrit une migration : un petit fichier qui décrit le changement. Comme il n'y a qu'une base, une migration appliquée touche aussi le site en ligne, tout de suite.
- Claude écrit la migration dans
supabase/migrations/et t'explique ce qu'elle change. - Il l'applique sur la base, avec ton accord.
- Tu vérifies en local que tout fonctionne.
- Le code qui utilise ce changement est mis en ligne.
Pour que le site en ligne continue de fonctionner entre les étapes 2 et 4, Claude ne fait d'abord que des ajouts. Supprimer ou renommer quelque chose se fait en deux temps, une fois que le site en ligne ne s'en sert plus.
À ne pas faire
Ne modifie pas la structure de la base directement dans le tableau de bord Supabase : le code et la base ne correspondraient plus. Modifier des données (corriger un contact, par exemple) ne pose aucun problème.
Les réglages secrets
Chaque environnement a ses propres clés (adresse de la base, clés d'accès aux services). Elles ne sont jamais dans le code.
- Local
- Dans le fichier
.env.local, sur ton ordinateur uniquement. Claude le récupère depuis Vercel. - Production
- Dans Vercel, rubrique Settings puis Environment Variables. Ce sont les mêmes que celles du local.
- Modèle
- Le fichier
.env.exampleliste les noms des clés attendues, sans leurs valeurs. Il est sur GitHub.
Revenir en arrière
- Le site public
Remets la version d'avant en ligne
Vercel peut aussi republier un ancien déploiement en un clic, depuis son tableau de bord.
- Ta version locale
- Annule ce que tu viens de faire ou Reviens à la version de ce matin
- La base de données
- Plus délicat : une donnée supprimée ne se récupère qu'avec une sauvegarde Supabase. C'est pour ça que Claude te demande toujours avant de supprimer des données ou d'appliquer une migration.
Questions fréquentes
- J'ai modifié, mais rien n'a changé en ligne.
- La modification n'a sans doute pas été mise en ligne, ou la mise en ligne a échoué. Demande Est-ce que ma dernière modification est en ligne ?
- Est-ce que je peux casser le site en testant en local ?
- Pas le code : tant que ce n'est pas mis en ligne, le site public ne bouge pas. Les données, en revanche, sont partagées : ce que tu ajoutes ou supprimes en local touche la vraie base.
- Et si la mise en ligne échoue ?
- L'ancienne version reste en ligne, intacte. Claude lit l'erreur et corrige.
- Le lien localhost ne s'ouvre plus.
- Le site local est arrêté (par exemple après avoir fermé Orca). Demande à Claude de le relancer.