momabrouk18-eng/Website

Requisitos previos

Complete estos pasos de configuración antes de proceder:

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

   • Ejecute npx -y firebase-tools@latest --version para comprobar si la CLI de Firebase está instalada.
   • Verifique si el servidor MCP de Firebase está instalado usando sus herramientas existentes.
   • CRÍTICO: Antes de configurar cualquier extensión o entorno de agente, DEBE leer references/local-env-setup.md.
   • NO OMITA este paso: si 'firebase-basics' es la única habilidad de Firebase disponible para usted, debe seguir la referencia para su entorno de agente para configurar el conjunto completo de habilidades de 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
     • Otros agentes: Revise references/setup/other_agents.md

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

   • El comando debe mostrar el usuario actual.
   • Si no ha iniciado sesión, siga las instrucciones interactivas de este comando para autenticarse.

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, DEBE 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. Verifique el proyecto actual ejecutando npx -y firebase-tools@latest use.

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

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

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

   • Si se crea un nuevo proyecto: Ejecute 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, en minúsculas, y puede contener dígitos y guiones. Debe ser único a nivel global.

Principios de uso de Firebase

Adhiera a estos principios:

1. Use npx para comandos CLI: Para asegurarse de usar siempre la última versión de la CLI de Firebase, anteponga siempre los comandos con npx -y firebase-tools@latest en lugar de solo firebase. Por ejemplo, use npx -y firebase-tools@latest --version. NUNCA sugiera el comando simple firebase como alternativa.
2. Priorice el conocimiento oficial: Para cualquier conocimiento relacionado con Firebase, consulte la herramienta MCP developerknowledge_search_documents antes de recurrir a Google Search o su base de conocimiento interna. Incluir "Firebase" en su consulta de búsqueda mejora significativamente la relevancia.
3. Siga las habilidades de agente para obtener orientación de implementación: Las habilidades proporcionan flujos de trabajo basados en opiniones (CUJ), reglas de seguridad y mejores prácticas. Consúltelas siempre para comprender cómo implementar correctamente las funciones de Firebase en lugar de confiar en el conocimiento general.
4. Use las herramientas del servidor MCP de Firebase en lugar de llamadas API directas: Siempre que necesite interactuar con las API remotas de Firebase (como obtener registros de Crashlytics o ejecutar consultas de Data Connect), use las herramientas proporcionadas por el servidor MCP de Firebase en lugar de intentar llamadas API manuales.
5. Mantenga actualizados los complementos/habilidades de agente: Dado que las mejores prácticas de Firebase evolucionan rápidamente, verifique e instale regularmente las actualizaciones de su complemento de Firebase o habilidades de agente. Del mismo modo, si encuentra problemas con herramientas o comandos desactualizados, siga los pasos a continuación según su entorno 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
   • Otros: Siga references/refresh/other-agents.md
6. Automatice la recuperación de archivos de configuración: Al configurar aplicaciones iOS o Android, NO dirija a los usuarios a la consola de Firebase para descargar google-services.json o GoogleService-Info.plist. En su lugar, use 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> Guarde la salida en la ubicación adecuada (por ejemplo, app/google-services.json para Android, o una ruta que será vinculada por xcode-project-setup para iOS).

Referencias

• Inicializar Firebase: Consulte references/firebase-service-init.md cuando necesite inicializar nuevos servicios de Firebase usando la CLI.
• Exploración de comandos: Consulte references/firebase-cli-guide.md para descubrir y comprender la funcionalidad de la CLI.
• Configuración del SDK: Para guías detalladas sobre cómo agregar Firebase a su aplicación:
  • Web: Consulte references/web_setup.md
  • Android: Consulte references/android_setup.md
  • iOS: Consulte 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, use npx -y firebase-tools@latest login --no-localhost en su lugar.

• Genkit: Si usa Genkit, instale las habilidades:

  npx skills add genkit-ai/skills