momabrouk18-eng/Website

Fournit la configuration de base du CLI Firebase : installation, vérification de version, connexion (y compris --no-localhost), création de projet, sélection de projet (`firebase use`) et téléchargement des fichiers de configuration d'application (`google-services.json`, `GoogleService-Info.plist`). À utiliser UNIQUEMENT pour la connexion au CLI, la création/changement de projet ou le téléchargement des fichiers de configuration d'application. Ne pas utiliser pour le déploiement Firebase Hosting, Firestore, Auth, App Hosting, Data Connect, Crashlytics ou Remote Config.

Qu'est-ce que Website ?

Cette compétence automate la configuration initiale et les opérations de base de Firebase via le CLI. Elle est conçue pour les agents IA (Gemini CLI, Antigravity, Android Studio, Claude Code, Cursor, GitHub Copilot) et garantit que l'environnement local est correctement préparé avant d'utiliser d'autres fonctionnalités Firebase. La compétence couvre la vérification de version du CLI, la connexion (y compris en mode sans navigateur), la création et la sélection de projet, ainsi que le téléchargement automatisé des fichiers de configuration (`google-services.json` pour Android, `GoogleService-Info.plist` pour iOS). Elle met l'accent sur l'utilisation de `npx -y firebase-tools@latest` pour garantir la version la plus récente, et elle s'appuie sur des principes de bonnes pratiques : consultation de la documentation officielle via l'outil MCP, utilisation des outils du serveur MCP Firebase, et mise à jour régulière des compétences. Les références incluses aident à initialiser des services Firebase, explorer les commandes du CLI et configurer les SDK Web/Android/iOS.

Compatible avec✓Claude Code~Codex CLI✓Cursor✓Antigravity✓Gemini CLI
npx skills add https://github.com/momabrouk18-eng/Website/tree/HEAD/.agents/skills/firebase-basics

Installed? Explore more Recherche et analyse de données skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Prérequis

Effectuez les étapes de configuration suivantes avant de continuer :

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

  2. Authentification : Assurez-vous d'être connecté à Firebase pour que les commandes disposent des permissions correctes. 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 poursuivre la configuration du projet, vous DEVEZ marquer 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.
    • En cas d'utilisation d'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 qu'il s'agit du projet souhaité.

      3. Sinon, ou si aucun projet n'est actif, définissez le projet fourni par l'utilisateur :

        npx -y firebase-tools@latest use <PROJECT_ID>
        
    • En cas de création d'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 : <project-id> doit comporter 6 à 30 caractères, en minuscules, et peut contenir des chiffres et des traits d'union. Il doit être unique au monde.

Principes d'utilisation de Firebase

Respectez ces principes :

  1. Utilisez npx pour les commandes CLI : Pour toujours utiliser la version la plus récente du CLI Firebase, préfixez toujours les commandes avec 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 la documentation officielle : Pour toute connaissance liée à Firebase, consultez l'outil MCP developerknowledge_search_documents avant de recourir à Google Search ou à votre base de connaissances interne. Inclure « Firebase » dans votre requête de recherche améliore considérablement la pertinence.
  3. Suivez les compétences de l'agent pour les conseils de mise en œuvre : Les compétences fournissent des workflows orientés (CUJ), des règles de sécurité et des bonnes pratiques. Consultez-les toujours pour comprendre comment implémenter correctement les fonctionnalités Firebase plutôt que 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 des requêtes Data Connect), utilisez les outils fournis par le serveur MCP Firebase au lieu de tenter des appels API manuels.
  5. Maintenez les plugins / compétences de l'agent à jour : Étant donné que les bonnes pratiques Firebase évoluent rapidement, vérifiez régulièrement et installez les mises à jour de leur plugin Firebase ou de leurs compétences d'agent. De même, si vous rencontrez des problèmes avec des outils ou des commandes obsolètes, suivez les étapes ci-dessous en fonction de votre environnement d'agent :
  6. Automatisez la récupération des fichiers 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. Utilisez plutôt le CLI Firebase pour récupérer la configuration par programme :
    • 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 à lier par xcode-project-setup pour iOS).

Références

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.

  • Genkit : Si vous utilisez Genkit, installez les compétences :

    npx skills add genkit-ai/skills
    

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

Skills associés