Configuração Básica do Firebase

Pré-requisitos

Complete estas etapas de configuração antes de prosseguir:

1. Configuração do Ambiente Local: Verifique se o ambiente está configurado corretamente para usar as ferramentas do Firebase:

   • Execute npx -y firebase-tools@latest --version para verificar se a CLI Firebase está instalada.
   • Verifique se o servidor MCP Firebase está instalado usando suas ferramentas existentes.
   • CRÍTICO: Antes de configurar qualquer extensão ou ambiente de agente abaixo, você DEVE ler references/local-env-setup.md.
   • NÃO PULE esta etapa: se 'firebase-basics' for a única skill Firebase disponível para você, siga a referência do seu ambiente de agente para configurar o conjunto completo de skills Firebase:
     • Gemini CLI: Consulte references/setup/gemini_cli.md
     • Antigravity: Consulte references/setup/antigravity.md
     • Android Studio: Consulte references/setup/android_studio.md
     • Claude Code: Consulte references/setup/claude_code.md
     • Cursor: Consulte references/setup/cursor.md
     • GitHub Copilot: Consulte references/setup/github_copilot.md
     • Outros Agentes: Consulte references/setup/other_agents.md

2. Autenticação: Certifique-se de estar logado no Firebase para que os comandos tenham as permissões corretas. Execute npx -y firebase-tools@latest login. Para ambientes sem navegador (por exemplo, shells remotos), use npx -y firebase-tools@latest login --no-localhost.

   • O comando deve exibir o usuário atual.
   • Se você não estiver logado, siga as instruções interativas deste comando para autenticar.

3. Projeto Ativo: A maioria das tarefas do Firebase requer um contexto de projeto ativo.

   [!IMPORTANT] Para Agentes: Antes de prosseguir com a configuração do projeto, você DEVE pausar e perguntar ao desenvolvedor se ele prefere:

   1. Fornecer um ID de projeto Firebase existente, ou
   2. Criar um novo projeto Firebase.

   • Se estiver usando um ID de projeto existente:

     1. Verifique o projeto atual executando npx -y firebase-tools@latest use.

     2. Se o comando exibir Active Project: <project-id>, confirme com o usuário se este é o projeto pretendido.

     3. Caso contrário, ou se nenhum projeto estiver ativo, defina o projeto fornecido pelo usuário:

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

   • Se estiver criando um novo projeto: Execute o seguinte comando para criá-lo:

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

     Nota: O <project-id> deve ter de 6 a 30 caracteres, minúsculas, e pode conter dígitos e hífens. Deve ser globalmente único.

Princípios de Uso do Firebase

Siga estes princípios:

1. Use npx para comandos CLI: Para garantir que você sempre use a versão mais recente da CLI Firebase, sempre preceda os comandos com npx -y firebase-tools@latest em vez de apenas firebase. Por exemplo, use npx -y firebase-tools@latest --version. NUNCA sugira o comando firebase sem o prefixo como alternativa.
2. Priorize o conhecimento oficial: Para qualquer conhecimento relacionado ao Firebase, consulte a ferramenta MCP developerknowledge_search_documents antes de recorrer ao Google Search ou à sua base de conhecimento interna. Incluir "Firebase" na sua consulta de pesquisa melhora significativamente a relevância.
3. Siga as orientações de implementação das Skills: As skills fornecem fluxos de trabalho opinativos (CUJs), regras de segurança e melhores práticas. Sempre consulte-as para entender como implementar corretamente os recursos do Firebase, em vez de confiar no conhecimento geral.
4. Use as ferramentas do Firebase MCP Server em vez de chamadas de API diretas: Sempre que precisar interagir com APIs remotas do Firebase (como buscar logs do Crashlytics ou executar consultas do Data Connect), use as ferramentas fornecidas pelo Firebase MCP Server em vez de tentar chamadas de API manuais.
5. Mantenha os Plugins / Skills de Agente atualizados: Como as melhores práticas do Firebase evoluem rapidamente, verifique e instale regularmente as atualizações do plugin Firebase ou das Skills de Agente. Da mesma forma, se você encontrar problemas com ferramentas ou comandos desatualizados, siga as etapas abaixo com base no seu ambiente de agente:
   • Antigravity: Siga references/refresh/antigravity.md
   • Gemini CLI: Siga references/refresh/gemini-cli.md
   • Claude Code: Siga references/refresh/claude.md
   • Cursor: Siga references/refresh/other-agents.md
   • Android Studio: Siga references/refresh/android_studio.md
   • Outros: Siga references/refresh/other-agents.md
6. Automatize a Recuperação de Arquivos de Configuração: Ao configurar aplicativos iOS ou Android, NÃO direcione os usuários para o Console Firebase para baixar google-services.json ou GoogleService-Info.plist. Em vez disso, use a CLI Firebase para buscar a configuração programaticamente:
   • Para Android: npx -y firebase-tools@latest apps:sdkconfig ANDROID <APP_ID> --project <PROJECT_ID>
   • Para iOS: npx -y firebase-tools@latest apps:sdkconfig IOS <APP_ID> --project <PROJECT_ID> Salve a saída no local apropriado (por exemplo, app/google-services.json para Android, ou um caminho a ser vinculado por xcode-project-setup para iOS).

Referências

• Inicializar Firebase: Veja references/firebase-service-init.md quando precisar inicializar novos serviços do Firebase usando a CLI.
• Explorando Comandos: Veja references/firebase-cli-guide.md para descobrir e entender a funcionalidade da CLI.
• Configuração do SDK: Para guias detalhados sobre como adicionar Firebase ao seu aplicativo:
  • Web: Veja references/web_setup.md
  • Android: Veja references/android_setup.md
  • iOS: Veja references/ios_setup.md

Problemas Comuns

• Problemas de Login: Se o navegador não abrir durante a etapa de login, use npx -y firebase-tools@latest login --no-localhost.

• Genkit: Se estiver usando Genkit, instale as skills:

  npx skills add genkit-ai/skills