momabrouk18-eng/Website

Implanta e gerencia aplicações web full-stack (Next.js, Angular) com Renderização no Servidor (SSR) usando o Firebase App Hosting. Use ao implantar apps Next.js/Angular, configurar blocos apphosting.yaml ou firebase.json, gerenciar segredos, configurar CI/CD com GitHub ou ajustar requisitos de faturamento Blaze. Não use para hospedagem estática clássica, Auth, Firestore, Crashlytics ou Xcode.

O que é Website?

Esta skill capacita o agente a implantar e gerenciar aplicações web full-stack modernas (como Next.js e Angular) utilizando o Firebase App Hosting. Ela é essencial para projetos que exigem Renderização no Servidor (SSR) ou Revalidação Incremental Estática (ISR), proporcionando um fluxo de trabalho automatizado com 'git push to deploy' e configuração zero. A skill suporta desde a configuração inicial do `firebase.json` e `apphosting.yaml`, passando pelo gerenciamento de segredos com `firebase-tools`, até a implantação manual via CLI ou configuração de CI/CD com GitHub. É importante notar que o Firebase App Hosting exige o plano de faturamento Blaze, e a skill pode orientar o usuário na atualização do plano. Não deve ser usada para sites estáticos, Auth, Firestore, Crashlytics ou Xcode, que pertencem a outras áreas do Firebase.

Funciona com~Claude Code~Codex CLI~Cursor

npx skills add https://github.com/momabrouk18-eng/Website/tree/HEAD/.agents/skills/firebase-app-hosting-basics

Documentação

Noções Básicas de App Hosting

Descrição

Esta skill permite que o agente implante e gerencie aplicações web full-stack modernas (Next.js, Angular, etc.) usando o Firebase App Hosting.

Importante: Para usar o App Hosting, seu projeto Firebase deve estar no plano de preços Blaze. Oriente o usuário a acessar https://console.firebase.google.com/project/_/overview?purchaseBillingPlan=metered para fazer upgrade do plano.

Hospedagem vs App Hosting

Escolha o Firebase Hosting se:

Você está implantando um site estático (HTML/CSS/JS).
Você está implantando uma SPA simples (React, Vue, etc. sem SSR).
Você deseja controle total sobre o processo de build e implantação via CLI.

Escolha o Firebase App Hosting se:

Você está usando um framework full-stack suportado, como Next.js ou Angular.
Você precisa de Renderização no Servidor (SSR) ou ISR.
Você deseja um fluxo de trabalho automatizado "git push to deploy" com configuração zero.

Implantação no App Hosting

Implantar a partir do Código Fonte

Este é o fluxo recomendado para a maioria dos usuários.

Configure o firebase.json com um bloco apphosting.

{
  "apphosting": {
    "backendId": "my-app-id",
    "rootDir": "/",
    "ignore": [
      "node_modules",
      ".git",
      "firebase-debug.log",
      "firebase-debug.*.log",
      "functions"
    ]
  }
}

Crie ou edite o apphosting.yaml — consulte Configuração para mais informações sobre como fazer isso.
Se o aplicativo precisar de acesso seguro a chaves sensíveis, use comandos npx -y firebase-tools@latest apphosting:secrets para definir e conceder acesso a segredos.
Execute npx -y firebase-tools@latest deploy quando estiver pronto para implantar.

Implantação automatizada via GitHub (CI/CD)

Alternativamente, configure um backend conectado a um repositório GitHub para implantações automatizadas "git push". Isso é recomendado apenas para usuários mais avançados e não é necessário para usar o App Hosting. Consulte Comandos CLI para mais informações sobre como configurar isso usando comandos CLI.

Emulação

Consulte Emulação para mais informações sobre como testar seu aplicativo localmente usando o Firebase Local Emulator Suite.