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

  1. LocalTon ordinateurVisible par toi seule
  2. GitHubLa sauvegardeGarde chaque version
  3. 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

LocalProduction
Adresselocalhost:3000Ton nom de domaine
Qui le voitToi, sur ton ordinateurTout le monde
Mis à jourInstantanément, à chaque modificationQuand tu dis à Claude de mettre en ligne
Base de donnéesLa même pour les deux : les vraies données
UsageConstruire, ajuster, vérifierAccueillir 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

  1. Tu vérifies le résultat en local, et tu ajustes jusqu'à ce qu'il te plaise.
  2. C'est bon, mets en ligne
  3. Claude vérifie que le site se construit sans erreur, enregistre la modification et l'envoie sur GitHub.
  4. 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.

  1. Claude écrit la migration dans supabase/migrations/ et t'explique ce qu'elle change.
  2. Il l'applique sur la base, avec ton accord.
  3. Tu vérifies en local que tout fonctionne.
  4. 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.example liste 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.