THE3RDTRAINER/Homepage

Requisitos previos

Completa estos pasos de configuración antes de continuar:

1. Configuración del entorno local: Verifica que el entorno esté configurado correctamente para poder usar las herramientas de Firebase:

   • Ejecuta npx -y firebase-tools@latest --version para comprobar si la CLI de Firebase está instalada.
   • Verifica si el servidor MCP de Firebase está instalado usando tus herramientas existentes.
   • CRÍTICO: Antes de configurar cualquier extensión o entorno de agente a continuación, DEBES leer references/local-env-setup.md.
   • NO OMITAS este paso: si 'firebase-basics' es el único skill de Firebase disponible para ti, debes seguir la referencia para tu entorno de agente a fin de configurar el conjunto completo de skills de Firebase:
     • Gemini CLI: Revisa references/setup/gemini_cli.md
     • Antigravity: Revisa references/setup/antigravity.md
     • Android Studio: Revisa references/setup/android_studio.md
     • Claude Code: Revisa references/setup/claude_code.md
     • Cursor: Revisa references/setup/cursor.md
     • GitHub Copilot: Revisa references/setup/github_copilot.md
     • Otros Agentes: Revisa references/setup/other_agents.md

2. Autenticación: Asegúrate de haber iniciado sesión en Firebase para que los comandos tengan los permisos correctos. Ejecuta npx -y firebase-tools@latest login. Para entornos sin navegador (por ejemplo, shells remotos), usa npx -y firebase-tools@latest login --no-localhost.

   • El comando debe mostrar el usuario actual.
   • Si no has iniciado sesión, sigue las instrucciones interactivas de este comando para autenticarte.

3. Proyecto activo: La mayoría de las tareas de Firebase requieren un contexto de proyecto activo.

   [!IMPORTANT] Para Agentes: Antes de continuar con la configuración del proyecto, DEBES pausar y preguntar al desarrollador si prefiere:

   1. Proporcionar un ID de proyecto de Firebase existente, o
   2. Crear un nuevo proyecto de Firebase.

   • Si se usa un ID de proyecto existente:

     1. Verifica el proyecto actual ejecutando npx -y firebase-tools@latest use.

     2. Si el comando muestra Active Project: <project-id>, confirma con el usuario si este es el proyecto deseado.

     3. Si no es así, o si no hay ningún proyecto activo, establece el proyecto proporcionado por el usuario:

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

   • Si se crea un nuevo proyecto: Ejecuta el siguiente comando para crearlo:

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

     Nota: El <project-id> debe tener entre 6 y 30 caracteres, estar en minúsculas y puede contener dígitos y guiones. Debe ser único a nivel global.

Principios de uso de Firebase

Adhiérete a estos principios:

1. Usa npx para los comandos de la CLI: Para asegurarte de usar siempre la versión más reciente de la CLI de Firebase, antepone siempre los comandos con npx -y firebase-tools@latest en lugar de solo firebase. Por ejemplo, usa npx -y firebase-tools@latest --version. NUNCA sugieras el comando simple firebase como alternativa.
2. Prioriza el conocimiento oficial: Para cualquier conocimiento relacionado con Firebase, consulta la herramienta MCP developerknowledge_search_documents antes de recurrir a Google Search o a tu base de conocimiento interna. Incluir "Firebase" en tu consulta de búsqueda mejora significativamente la relevancia.
3. Sigue los Skills del Agente para obtener orientación sobre la implementación: Los skills proporcionan flujos de trabajo específicos (CUJs), reglas de seguridad y mejores prácticas. Consúltalos siempre para entender cómo implementar las funciones de Firebase correctamente en lugar de basarte en el conocimiento general.
4. Usa las herramientas del servidor MCP de Firebase en lugar de llamadas directas a la API: Siempre que necesites interactuar con las APIs remotas de Firebase (como obtener registros de Crashlytics o ejecutar consultas de Data Connect), usa las herramientas proporcionadas por el servidor MCP de Firebase en lugar de intentar llamadas manuales a la API.
5. Mantén actualizados los Plugins / Skills del Agente: Dado que las mejores prácticas de Firebase evolucionan rápidamente, verifica e instala regularmente las actualizaciones de su plugin de Firebase o Skills del Agente. De manera similar, si encuentras problemas con herramientas o comandos obsoletos, sigue los pasos a continuación según tu entorno de agente:
   • Antigravity: Sigue references/refresh/antigravity.md
   • Gemini CLI: Sigue references/refresh/gemini-cli.md
   • Claude Code: Sigue references/refresh/claude.md
   • Cursor: Sigue references/refresh/other-agents.md
   • Android Studio: Sigue references/refresh/android_studio.md
   • Otros: Sigue references/refresh/other-agents.md
6. Automatiza la recuperación de archivos de configuración: Al configurar aplicaciones iOS o Android, NO dirijas a los usuarios a la consola de Firebase para descargar google-services.json o GoogleService-Info.plist. En su lugar, usa la CLI de Firebase para obtener la configuración mediante programación:
   • 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> Guarda la salida en la ubicación adecuada (por ejemplo, app/google-services.json para Android, o una ruta que se enlazará mediante xcode-project-setup para iOS).

Referencias

• Inicializar Firebase: Consulta references/firebase-service-init.md cuando necesites inicializar nuevos servicios de Firebase usando la CLI.
• Explorar comandos: Consulta references/firebase-cli-guide.md para descubrir y entender la funcionalidad de la CLI.
• Configuración del SDK: Para guías detalladas sobre cómo añadir Firebase a tu aplicación:
  • Web: Consulta references/web_setup.md
  • Android: Consulta references/android_setup.md
  • iOS: Consulta references/ios_setup.md

Problemas comunes

• Problemas de inicio de sesión: Si el navegador no se abre durante el paso de inicio de sesión, usa npx -y firebase-tools@latest login --no-localhost en su lugar.

• Genkit: Si usas Genkit, instala los skills:

  npx skills add genkit-ai/skills