Firebase App Hosting para aplicações full-stack

O que esta skill faz

Esta skill cobre a publicação de aplicações web full-stack no Firebase App Hosting. O fluxo inclui configuração de backend, apphosting.yaml, secrets e deploy a partir do código-fonte.

Quando usar

• Publicar uma aplicação Next.js com backend
• Hospedar um projeto Angular full-stack
• Configurar SSR ou ISR no ambiente Firebase
• Conceder acesso seguro a secrets da aplicação

Como usar

1. Revise o repositório, o framework e o diretório raiz da aplicação
2. Confirme que o projeto Firebase usa o plano Blaze
3. Adicione o bloco apphosting ao firebase.json
4. Configure apphosting.yaml e os secrets necessários
5. Execute o fluxo de deploy com firebase-tools

O que revisar antes de instalar

• Exige que o projeto Firebase esteja no plano Blaze
• Não é a opção indicada para um site puramente estático
• A compatibilidade depende dos frameworks aceitos pelo serviço

SKILL.md

---
name: firebase-app-hosting-basics
description: Deploy and manage web apps with Firebase App Hosting. Use this skill when deploying Next.js/Angular apps with backends.
---

# App Hosting Basics

## Description
This skill enables the agent to deploy and manage modern, full-stack web applications (Next.js, Angular, etc.) using Firebase App Hosting. 

**Important**: In order to use App Hosting, your Firebase project must be on the Blaze pricing plan. Direct the user to https://console.firebase.google.com/project/_/overview?purchaseBillingPlan=metered to upgrade their plan.

## Hosting vs App Hosting

**Choose Firebase Hosting if:**
- You are deploying a static site (HTML/CSS/JS).
- You are deploying a simple SPA (React, Vue, etc. without SSR).
- You want full control over the build and deploy process via CLI.

**Choose Firebase App Hosting if:**
- You are using a supported full-stack framework like Next.js or Angular.
- You need Server-Side Rendering (SSR) or ISR.
- You want an automated "git push to deploy" workflow with zero configuration.

## Deploying to App Hosting

### Deploy from Source

This is the recommended flow for most users. 
1. Configure `firebase.json` with an `apphosting` block.
    ```json
    {
      "apphosting": {
        "backendId": "my-app-id",
        "rootDir": "/",
        "ignore": [
          "node_modules",
          ".git",
          "firebase-debug.log",
          "firebase-debug.*.log",
          "functions"
        ]
      }
    }
    ```
2. Create or edit `apphosting.yaml`- see [Configuration](references/configuration.md) for more information on how to do so.
3. If the app needs safe access to sensitive keys, use `npx -y firebase-tools@latest apphosting:secrets` commands to set and grant access to secrets.
4. Run `npx -y firebase-tools@latest deploy` when you are ready to deploy.

### Automated deployment via GitHub (CI/CD)

Alternatively, set up a backend connected to a GitHub repository for automated deployments "git push" deployments.
This is only recommended for more advanced users, and is not required to use App Hosting.
See [CLI Commands](references/cli_commands.md) for more information on how to set this up using CLI commands.

## Emulation

See [Emulation](references/emulation.md) for more information on how to test your app locally using the Firebase Local Emulator Suite.