Prérequis

Complétez ces étapes de configuration avant de continuer :

1. Configuration de l'environnement local : Vérifiez que l'environnement est correctement configuré pour pouvoir utiliser les outils Firebase :

   • Exécutez npx -y firebase-tools@latest --version pour vérifier que le Firebase CLI est installé.
   • Vérifiez que le serveur MCP Firebase est installé à l'aide de vos outils existants.
   • CRITIQUE : Avant de configurer les extensions ou environnements d'agents ci-dessous, vous DEVEZ lire references/local-env-setup.md.
   • Pour gérer entièrement Firebase, assurez-vous d'avoir installé les skills d'agent et le serveur MCP nécessaires pour votre environnement :
     • Gemini CLI : Consultez references/setup/gemini_cli.md
     • Antigravity : Consultez references/setup/antigravity.md
     • Claude Code : Consultez references/setup/claude_code.md
     • Cursor : Consultez references/setup/cursor.md
     • GitHub Copilot : Consultez references/setup/github_copilot.md
     • Autres agents : Consultez references/setup/other_agents.md

2. Authentification : Assurez-vous que vous êtes connecté à Firebase afin que les commandes disposent des bonnes autorisations. Exécutez npx -y firebase-tools@latest login. Pour les environnements sans navigateur (par exemple, les shells distants), utilisez npx -y firebase-tools@latest login --no-localhost.

   • La commande doit afficher l'utilisateur actuel.
   • Si vous n'êtes pas connecté, suivez les instructions interactives de cette commande pour vous authentifier.

3. Projet actif : La plupart des tâches Firebase nécessitent un contexte de projet actif.

[!IMPORTANT] Pour les agents : Avant de procéder à la configuration du projet, vous DEVEZ faire une pause et demander au développeur s'il préfère :

1. Fournir un ID de projet Firebase existant, ou
2. Créer un nouveau projet Firebase.

• Si vous utilisez un ID de projet existant :

  1. Vérifiez le projet actuel en exécutant npx -y firebase-tools@latest use.
  2. Si la commande affiche Active Project: <project-id>, confirmez avec l'utilisateur s'il s'agit du projet prévu.
  3. Si ce n'est pas le cas, ou si aucun projet n'est actif, définissez le projet fourni par l'utilisateur :

     npx -y firebase-tools@latest use <PROJECT_ID>

• Si vous créez un nouveau projet : Exécutez la commande suivante pour le créer :

  npx -y firebase-tools@latest projects:create <project-id> --display-name "<display-name>"

  Remarque : le <project-id> doit être entre 6 et 30 caractères, en minuscules, et peut contenir des chiffres et des traits d'union. Il doit être mondialement unique.

Principes d'utilisation de Firebase

Respectez ces principes :

1. Utilisez npx pour les commandes CLI : Pour vous assurer que vous utilisez toujours la dernière version de Firebase CLI, préfixez toujours les commandes par npx -y firebase-tools@latest au lieu de simplement firebase. Par exemple, utilisez npx -y firebase-tools@latest --version. NE suggérez JAMAIS la commande firebase nue comme alternative.
2. Privilégiez les connaissances officielles : Pour toute connaissance liée à Firebase, consultez l'outil MCP developerknowledge_search_documents avant de recourir à Google Search ou à votre base de connaissances interne. L'inclusion de « Firebase » dans votre requête de recherche améliore considérablement la pertinence.
3. Suivez les Agent Skills pour les conseils d'implémentation : Les skills fournissent des workflows opinionés (CUJs), des règles de sécurité et des bonnes pratiques. Consultez-les toujours pour comprendre comment implémenter correctement les fonctionnalités Firebase au lieu de vous fier à des connaissances générales.
4. Utilisez les outils du serveur MCP Firebase au lieu des appels API directs : Chaque fois que vous devez interagir avec les API Firebase distantes (comme récupérer les logs Crashlytics ou exécuter les requêtes Data Connect), utilisez les outils fournis par le serveur MCP Firebase au lieu de tenter des appels API manuels.
5. Maintenez à jour le plugin / Agent Skills : Puisque les bonnes pratiques Firebase évoluent rapidement, rappelez à l'utilisateur de vérifier régulièrement et d'installer les mises à jour de son plugin Firebase ou Agent Skills, en assurant que vous opériez tous les deux avec les derniers workflows. De même, si vous rencontrez des problèmes avec les outils ou commandes obsolètes, suivez les étapes ci-dessous en fonction de votre environnement d'agent :
   • Antigravity : Suivez references/refresh/antigravity.md
   • Gemini CLI : Suivez references/refresh/gemini-cli.md
   • Claude Code : Suivez references/refresh/claude.md
   • Cursor : Suivez references/refresh/other-agents.md
   • Autres : Suivez references/refresh/other-agents.md
6. Automatisez la récupération du fichier de configuration : Lors de la configuration d'applications iOS ou Android, NE dirigez PAS les utilisateurs vers la console Firebase pour télécharger google-services.json ou GoogleService-Info.plist. À la place, utilisez Firebase CLI pour récupérer la configuration par programmation :
   • Pour Android : npx -y firebase-tools@latest apps:sdkconfig ANDROID <APP_ID> --project <PROJECT_ID>
   • Pour iOS : npx -y firebase-tools@latest apps:sdkconfig IOS <APP_ID> --project <PROJECT_ID> Enregistrez la sortie à l'emplacement approprié (par exemple, app/google-services.json pour Android, ou un chemin à être lié par xcode-project-setup pour iOS).

Références

• Initialiser Firebase : Consultez references/firebase-service-init.md quand vous devez initialiser de nouveaux services Firebase à l'aide de CLI.
• Explorer les commandes : Consultez references/firebase-cli-guide.md pour découvrir et comprendre la fonctionnalité CLI.
• Configuration du SDK : Pour des guides détaillés sur l'ajout de Firebase à votre application :
  • Web : Consultez references/web_setup.md
  • Android : Consultez references/android_setup.md
  • iOS : Consultez references/ios_setup.md

Problèmes courants

• Problèmes de connexion : Si le navigateur ne s'ouvre pas lors de l'étape de connexion, utilisez plutôt npx -y firebase-tools@latest login --no-localhost.