THE3RDTRAINER/Homepage

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

O que é Homepage?

Este skill permite que o agente implante e gerencie aplicações web full-stack modernas, como Next.js e Angular, utilizando o Firebase App Hosting. Ele é útil para desenvolvedores que precisam de Server-Side Rendering (SSR) ou Incremental Static Regeneration (ISR) sem a complexidade de configurar servidores manualmente. O skill suporta Firebase App Hosting como plataforma principal e requer que o projeto esteja no plano de preços Blaze. Ele fornece orientações claras sobre configuração de `firebase.json` com o bloco `apphosting`, criação/revisão do arquivo `apphosting.yaml`, gerenciamento de segredos com comandos CLI e execução de deploys via `firebase deploy`. Além disso, oferece suporte a deploys automatizados via GitHub CI/CD para usuários avançados. O skill também diferencia claramente quando usar Firebase Hosting (estático) versus App Hosting (full-stack com SSR), evitando confusões com serviços como Auth, Firestore ou Crashlytics. O conteúdo do SKILL.md inclui referências a documentação de emulação local via Firebase Local Emulator Suite, garantindo que o desenvolvedor possa testar a aplicação antes de implantar. Em resumo, é uma ferramenta indispensável para orquestrar deploys contínuos de aplicações modernas no ecossistema Firebase.

Funciona com~Claude Code~Codex CLI~Cursor

npx skills add https://github.com/THE3RDTRAINER/Homepage/tree/HEAD/.agents/skills/firebase-app-hosting-basics

Documentação

Noções Básicas do App Hosting

Descrição

Este 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. Direcione o usuário para https://console.firebase.google.com/project/_/overview?purchaseBillingPlan=metered para fazer upgrade do plano.

Hospedagem vs App Hosting

Escolha 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ê quer controle total sobre o processo de build e deploy via CLI.

Escolha Firebase App Hosting se:

Você está usando um framework full-stack compatível, como Next.js ou Angular.
Você precisa de Renderização no Lado do Servidor (SSR) ou ISR.
Você quer um fluxo de trabalho automatizado "git push para deploy" com configuração zero.

Implantando no App Hosting

Implantar a partir do Código Fonte

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

Configure 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 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 via "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.