Guide de déploiement

Prérequis

  • Node.js 20+
  • Un projet Supabase
  • Une clĂ© API Lingo.dev
  • Un compte Vercel (pour le dĂ©ploiement)
  • Un compte GitHub (pour CI/CD)

Étape 1 : configuration de Supabase

  1. Créez un nouveau projet sur supabase.com
  2. Accédez à l'éditeur SQL
  3. Exécutez le SQL depuis lib/supabase.ts (la section commentée en bas)
  4. Copiez l'URL de votre projet et les clés depuis Paramètres → API

Étape 2 : variables d'environnement

Créez .env.local avec vos valeurs réelles :

LINGODOTDEV_API_KEY=your_key
NEXT_PUBLIC_SUPABASE_URL=https://your-project.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_anon_key
SUPABASE_SERVICE_ROLE_KEY=your_service_key
NEXT_PUBLIC_APP_URL=https://your-app.vercel.app

Étape 3 : traduire la documentation

Exécutez la CLI Lingo pour générer les traductions de toute la documentation :

npm run translate:docs

Cela crée la documentation traduite dans docs/es/, docs/fr/, docs/de/, docs/ja/ et docs/zh/.

Étape 4 : déployer sur Vercel

  1. Poussez votre code sur GitHub
  2. Accédez à vercel.com et importez votre dépôt
  3. Ajoutez toutes les variables d'environnement dans le tableau de bord Vercel
  4. Déployez

Étape 5 : GitHub Actions (CI/CD)

  1. Accédez à votre dépôt GitHub → Paramètres → Secrets and variables → Actions
  2. Ajoutez le secret : LINGODOTDEV_API_KEY
  3. Le workflow dans .github/workflows/translate-docs.yml traduira automatiquement la documentation Ă  chaque push

Étape 6 : configurer Lingo MCP dans Cursor

  1. Ouvrez les paramètres de Cursor → onglet MCP
  2. Ajoutez un nouveau serveur MCP :
    • Nom : Lingo.dev
    • Commande : npx
    • Args : ["-y", "lingo.dev", "mcp", "YOUR_API_KEY"]
  3. Redémarrez Cursor
  4. Vérifiez l'indicateur de statut vert

Liste de vérification pour la production

  • Tables Supabase créées avec RLS activĂ©
  • Toutes les variables d'environnement dĂ©finies dans Vercel
  • Lingo Compiler compile les traductions au dĂ©ploiement
  • Documentation traduite via CLI
  • Workflow CI/CD testĂ©
  • MCP configurĂ© dans l'environnement de dĂ©veloppement
  • DonnĂ©es de dĂ©monstration gĂ©nĂ©rĂ©es pour la prĂ©sentation
  • Les 5 outils Lingo.dev vĂ©rifiĂ©s et fonctionnels

Surveillance

Après le déploiement, surveillez votre application :

  • Tableau de bord Vercel — Journaux de dĂ©ploiement et analyses
  • Tableau de bord Supabase — Surveillance de la base de donnĂ©es et journaux
  • GitHub Actions — Statut du pipeline CI/CD