Les mots techniques, expliqués simplement.

Tu n'as pas besoin de les retenir : Claude s'occupe de la technique. Ce lexique sert à comprendre ce qu'il te raconte.

Les bases

Les mots qui reviennent partout.

Orca: L'application dans laquelle tu travailles sur le projet. Elle ouvre le dossier, lance Claude Code et peut gérer plusieurs copies du projet en parallèle.
Claude Code: L'assistant à qui tu demandes les modifications. Il lit le projet, écrit le code, lance les commandes et s'occupe de GitHub.
Skill: Une compétence spécialisée que Claude charge quand il en a besoin : rédaction, design, SEO… Celles du projet sont dans .claude/skills/.
Terminal: Une fenêtre où l'on tape des instructions au lieu de cliquer. Claude l'utilise pour toi.
Commande: Une instruction tapée dans le terminal, comme npm run dev.
CLI: « Command Line Interface » : un outil qu'on utilise depuis le terminal. Exemples : gh pour GitHub, vercel, supabase.
Dossier du projet: Le dossier sur ton ordinateur qui contient tout le site. On l'appelle aussi la racine du projet.
Fichier .md (Markdown): Un fichier de texte simple avec une mise en forme légère : # pour un titre, - pour une liste. CHANGELOG.md et MEMORY.md en sont.
README.md: Le fichier de présentation du projet, affiché en premier sur GitHub.
Navigateur: Chrome, Safari, Arc… le logiciel avec lequel tu ouvres les sites.
Homebrew (brew): L'installateur d'outils du Mac. brew install gh installe l'outil GitHub, par exemple.
Docker: Un logiciel qui fait tourner des services sur ton ordinateur dans des boîtes isolées. Nécessaire seulement pour lancer une base Supabase en local.
MCP: Un branchement qui permet à Claude d'utiliser directement un service (Supabase, Vercel…) sans passer par le terminal.

Le site

Comment le site est construit et ce qui le fait tourner.

Next.js: L'outil avec lequel le site est construit. Il s'occupe des pages, des liens et de la rapidité du site.
React: La technologie sur laquelle repose Next.js. Les morceaux de page réutilisables s'appellent des composants.
Composant: Un morceau de page réutilisable : un bouton, un en-tête, une carte de tarif.
Page / route: Une adresse du site, comme /lexique. Chaque dossier de app/ qui contient un page.tsx devient une page.
TypeScript (.ts, .tsx): Le langage dans lequel le site est écrit. Les fichiers .tsx contiennent des pages ou des composants.
CSS: Le langage qui décrit l'apparence : couleurs, tailles, espacements.
Node.js: Le logiciel qui fait tourner le site sur ton ordinateur.
npm: L'outil qui installe les briques dont le site a besoin et lance les commandes du projet.
Dépendance: Une brique logicielle écrite par d'autres et utilisée par le site (Next.js, React…). Elles sont listées dans package.json.
package.json: La fiche d'identité technique du projet : ses dépendances et ses commandes.
node_modules: Le dossier où npm range les dépendances. Il est lourd, recréé par npm install, et jamais envoyé sur GitHub.
API: Une porte d'entrée qui permet à deux logiciels de se parler. Le site parle à Supabase via son API.
Clé API / token: Un mot de passe réservé aux logiciels. À traiter comme un vrai mot de passe : jamais dans le code, jamais partagé.
Webhook: Un message envoyé automatiquement par un service quand quelque chose se passe, par exemple un paiement reçu.
SEO: Le référencement : tout ce qui aide ton site à apparaître dans les résultats de Google.
Responsive: Un site qui s'adapte à toutes les tailles d'écran, du téléphone à l'ordinateur.

Local et production

Les différents exemplaires de ton site. Tout est détaillé dans la page Local & production.

Environnement: Un exemplaire du site avec ses propres réglages : local ou production.
Local: Le site qui tourne sur ton ordinateur, visible par toi seule.
localhost:3000: L'adresse du site local dans ton navigateur. Elle ne fonctionne que sur ton ordinateur, et seulement quand le site local est lancé.
Serveur de développement: Le programme qui fait tourner le site local et l'actualise à chaque modification. Lancé par npm run dev.
Production (prod): Le vrai site, visible par tout le monde.
Variable d'environnement: Un réglage, souvent secret, qui change selon l'environnement : l'adresse de la base, une clé d'accès. Jamais écrit dans le code.
.env.local: Le fichier des variables d'environnement sur ton ordinateur. Il n'est jamais envoyé sur GitHub.
.env.example: Le modèle qui liste les variables attendues, sans leurs valeurs. Lui est sur GitHub.
Mise en ligne: Le passage d'une modification en production.

GitHub

L'historique et la sauvegarde du code.

Git: Le logiciel qui garde l'historique de chaque modification du projet.
GitHub: Le site qui héberge cet historique en ligne. C'est la sauvegarde de référence de ton site.
Dépôt (repo): Le projet et tout son historique. Le tien est privé et t'appartient.
Commit: Une sauvegarde nommée d'un ensemble de modifications, par exemple « Ajoute la page Contact ». On peut toujours revenir à un commit précédent.
Historique (log): La liste de tous les commits, du plus récent au plus ancien.
Diff: La différence entre deux versions : ce qui a été ajouté, modifié ou supprimé.
Push: Envoyer tes commits sur GitHub.
Pull: Récupérer les commits présents sur GitHub, par exemple ceux faits par Ugo.
Clone: Télécharger un dépôt GitHub sur ton ordinateur, la première fois.
Branche: Une copie de travail parallèle pour préparer une modification sans toucher au site en ligne.
main: La branche principale. Ce qui arrive sur main est mis en production automatiquement.
Merge (fusion): Intégrer une branche dans main une fois la modification validée.
Conflit: Quand deux modifications touchent la même ligne. Claude le résout et te demande quelle version garder si besoin.
Synchroniser: Mettre tes deux Mac d'accord : envoyer sur GitHub depuis l'un, récupérer depuis l'autre.
en-cours: La sauvegarde à part où Claude range un travail pas terminé pour que tu le reprennes sur l'autre Mac. Elle n'est jamais publiée sur ton site.
Revert: Annuler un commit en créant un nouveau commit inverse. L'historique reste intact.
.gitignore: La liste des fichiers que Git ne doit jamais sauvegarder : secrets, node_modules…
Worktree: Une copie supplémentaire du projet sur une autre branche, pour travailler sur deux sujets en parallèle. Orca s'en sert.
Issue: Une fiche sur GitHub pour noter un bug ou une idée à traiter plus tard.

Vercel

L'hébergement du site.

Vercel: Le service qui héberge ton site et le met en ligne automatiquement à chaque modification sur GitHub.
Hébergement: L'ordinateur, allumé en permanence, sur lequel ton site est disponible pour le monde entier.
Déploiement: Une mise en ligne d'une version du site. Chacune est conservée dans Vercel.
Build: L'étape où le code est transformé en site prêt à être servi. S'il échoue, l'ancienne version reste en ligne.
Logs: Le journal de ce qui s'est passé pendant un build ou sur le site. Claude le lit pour comprendre une erreur.
Rollback: Remettre en ligne un déploiement précédent en un clic.
Nom de domaine: L'adresse de ton site, comme maryamgadery.com. Il s'achète chez un registraire puis se relie à Vercel.
DNS: L'annuaire d'internet, qui fait correspondre ton nom de domaine à Vercel. Se règle une fois chez le registraire.
HTTPS / SSL: Le cadenas dans le navigateur : la connexion au site est chiffrée. Vercel s'en occupe tout seul.
Fonction serverless: Un bout de code exécuté par Vercel à la demande, par exemple pour envoyer un formulaire.
Cache: Une copie gardée en mémoire pour aller plus vite. Si un changement n'apparaît pas, c'est parfois le cache : recharge avec Cmd + Maj + R.

Supabase

La base de données, les comptes utilisateurs et les fichiers.

Supabase: Le service qui fournit la base de données du site, la gestion des comptes et le stockage de fichiers.
Base de données: L'endroit où sont rangées les données du site (contacts, inscriptions, contenus), sous forme de tableaux.
Table: Un tableau de la base, par exemple « contacts ».
Colonne: Un type d'information dans une table, par exemple « email ».
Ligne: Une entrée dans une table : un contact, une inscription.
Schéma: La structure de la base : quelles tables, quelles colonnes, quels liens entre elles.
SQL: Le langage pour lire et modifier une base de données. Claude l'écrit pour toi.
Migration: Un fichier qui décrit un changement de structure de la base. Rangé dans supabase/migrations/. Comme il n'y a qu'une base, une migration appliquée touche aussi le site en ligne.
Seed: Des fausses données de départ pour remplir une base vide.
Auth: La gestion des comptes : inscription, connexion, mot de passe oublié.
Storage / bucket: Le stockage de fichiers (images, PDF). Un bucket est un dossier de stockage.
RLS (Row Level Security): Les règles qui disent qui a le droit de lire ou modifier chaque ligne. Indispensable : sans elles, les données peuvent être lisibles par n'importe qui.
Policy: Une règle RLS précise, par exemple « un visiteur peut ajouter un contact mais pas lire les autres ».
Clé anon (publishable): La clé publique utilisée par le site. Elle peut être visible : ce sont les RLS qui protègent les données.
Clé service_role (secret): La clé qui donne tous les droits sur la base. Ne doit jamais apparaître dans le navigateur ni sur GitHub.
Project ref: L'identifiant de ton projet Supabase, visible dans l'adresse du tableau de bord.
Edge Function: Un bout de code exécuté par Supabase, par exemple pour envoyer un e-mail automatique.
Sauvegarde (backup): Une copie de la base, faite automatiquement chaque jour sur l'offre payante de Supabase.
Types générés: Un fichier qui décrit les tables pour le code, régénéré après chaque migration.

Les commandes

Claude les lance pour toi. Elles sont là pour que tu reconnaisses ce qu'il fait.

npm install: Installe les dépendances du projet. À faire après avoir récupéré le projet.
npm run dev: Lance le site en local sur localhost:3000.
npm run build: Construit le site comme Vercel le ferait. Utile pour vérifier qu'il n'y a pas d'erreur avant une mise en ligne.
git status: Affiche ce qui a été modifié depuis le dernier commit.
git add / git commit: Prépare puis enregistre une sauvegarde nommée des modifications.
git push / git pull: Envoie les commits sur GitHub / récupère ceux de GitHub.
git switch -c <nom>: Crée une nouvelle branche et s'y place.
gh auth login: Te connecte à GitHub depuis ton ordinateur. Une seule fois.
gh repo clone <compte>/<repo>: Télécharge le projet sur ton ordinateur.
vercel login: Te connecte à Vercel. Une seule fois.
vercel link: Relie le dossier local à ton projet Vercel.
vercel env pull .env.local: Récupère les variables d'environnement de Vercel dans le fichier local.
vercel --prod: Met la production à jour à la main. Rarement utile : l'envoi sur GitHub suffit.
supabase login: Te connecte à Supabase. Une seule fois.
supabase link --project-ref <ref>: Relie le dossier local à un projet Supabase.
supabase migration new <nom>: Crée un nouveau fichier de migration vide, à remplir.
supabase db push: Applique les nouvelles migrations sur la base reliée. Sur la production, seulement après validation.
supabase db pull: Récupère la structure actuelle de la base en ligne sous forme de migration.
supabase gen types typescript --linked: Génère la description des tables pour le code, après chaque migration.
supabase start: Lance une copie de la base sur ton ordinateur pour tester sans risque. Nécessite Docker.