THE3RDTRAINER/Homepage

Fournit une configuration de base de la CLI Firebase, l'installation, les vérifications de version, la connexion, la création et la sélection de projet, ainsi que le téléchargement des fichiers de configuration d'application.

Qu'est-ce que Homepage ?

Cette compétence (skill) est un guide de démarrage essentiel pour tout développeur utilisant Firebase avec des agents IA comme Claude Code, Cursor ou Gemini CLI. Elle définit les principes fondamentaux : utiliser `npx -y firebase-tools@latest` pour toujours exécuter la dernière version de la CLI Firebase, se connecter avec `firebase login` (avec l'option `--no-localhost` pour les environnements sans navigateur), et configurer un projet Firebase actif. La compétence automatise également le téléchargement des fichiers de configuration d'application (`google-services.json` pour Android, `GoogleService-Info.plist` pour iOS) via des commandes CLI, évitant ainsi aux développeurs de se rendre dans la console Firebase. En suivant ces workflows, les agents peuvent préparer efficacement un environnement Firebase complet, s'assurer que les bonnes permissions sont en place et éviter les pièges courants comme une mauvaise configuration de projet ou des outils obsolètes. Elle est conçue pour être utilisée indépendamment d'autres compétences Firebase avancées (Hébergement, Firestore, Auth, etc.) et sert de première étape obligatoire avant d'activer tout service Firebase.

Compatible avec✓Claude Code~Codex CLI✓Cursor✓Antigravity✓Gemini CLI
npx skills add https://github.com/THE3RDTRAINER/Homepage/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 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 :

  2. Authentification : Assurez-vous d'être connecté à Firebase pour que les commandes disposent des autorisations 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 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 qu'il s'agit du projet prévu.

      3. Dans le cas contraire, 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 comporter 6 à 30 caractères, en minuscules, et peut contenir des chiffres et des tirets. Il doit être globalement unique.

Principes d'utilisation de Firebase

Respectez ces principes :

  1. Utilisez npx pour les commandes CLI : Pour vous assurer d'utiliser toujours la dernière version de la CLI Firebase, faites toujours précéder les commandes de 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 nue firebase comme alternative.
  2. Priorisez les connaissances officielles : Pour toute connaissance liée à Firebase, consultez l'outil MCP developerknowledge_search_documents avant de recourir à une recherche Google 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 d'implémentation : Les compétences fournissent des workflows (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 plutôt que des appels API directs : Chaque fois que vous avez besoin d'interagir avec les API Firebase distantes (comme la récupération des logs Crashlytics ou l'exécution de requêtes Data Connect), utilisez les outils fournis par le serveur MCP Firebase au lieu de tenter des appels API manuels.
  5. Maintenez à jour les plugins / compétences de l'agent : Comme les bonnes pratiques Firebase évoluent rapidement, vérifiez et installez régulièrement 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 la 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