THE3RDTRAINER/Homepage

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 usarmos as ferramentas Firebase:

   • Execute npx -y firebase-tools@latest --version para verificar se a CLI do Firebase está instalada.
   • Verifique se o servidor MCP do Firebase está instalado usando suas ferramentas existentes.
   • CRÍTICO: Antes de configurar quaisquer extensões ou ambientes 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ê, você deve seguir a referência para seu ambiente de agente e configurar o conjunto completo de skills Firebase:
     • Gemini CLI: Revise references/setup/gemini_cli.md
     • Antigravity: Revise references/setup/antigravity.md
     • Android Studio: Revise references/setup/android_studio.md
     • Claude Code: Revise references/setup/claude_code.md
     • Cursor: Revise references/setup/cursor.md
     • GitHub Copilot: Revise references/setup/github_copilot.md
     • Outros Agentes: Revise 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 (ex.: 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 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 o uso da versão mais recente da CLI do Firebase, sempre preceda os comandos com npx -y firebase-tools@latest ao invés de apenas firebase. Por exemplo, use npx -y firebase-tools@latest --version. NUNCA sugira o comando firebase puro como alternativa.
2. Priorize o conhecimento oficial: Para qualquer conhecimento relacionado ao Firebase, consulte a ferramenta MCP developerknowledge_search_documents antes de recorrer à Pesquisa Google ou sua base de conhecimento interna. Incluir "Firebase" na sua consulta de pesquisa melhora significativamente a relevância.
3. Siga as Skills de Agente para orientação de implementação: As skills fornecem fluxos de trabalho opinativos (CUJs), regras de segurança e melhores práticas. Consulte-as sempre para entender como implementar recursos do Firebase corretamente, em vez de confiar no conhecimento geral.
4. Use as ferramentas do Servidor MCP do Firebase em vez de chamadas diretas à API: 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 Servidor MCP do Firebase em vez de tentar chamadas manuais de API.
5. Mantenha Plugins / Skills de Agente atualizados: Como as melhores práticas do Firebase evoluem rapidamente, verifique e instale regularmente atualizações do plugin Firebase ou das Skills de Agente. Da mesma forma, se 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 Obtenção de Arquivos de Configuração: Ao configurar apps 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 do 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 (ex.: app/google-services.json para Android, ou um caminho a ser vinculado pelo xcode-project-setup para iOS).

Referências

• Inicializar o Firebase: Consulte references/firebase-service-init.md quando precisar inicializar novos serviços Firebase usando a CLI.
• Explorando Comandos: Consulte 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 app:
  • Web: Consulte references/web_setup.md
  • Android: Consulte references/android_setup.md
  • iOS: Consulte 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