1. Instalar Firebase CLI (uma vez)

Prompt original

quero publicar a documentação no firebase hosting como configuro pra isso?

Contexto

O site de documentação estática do projeto SinergIA, gerado com Astro + Starlight, estava rodando apenas localmente via scripts/showDocs.ps1. O objetivo era configurar o deploy contínuo para o Firebase Hosting.

Resultado

Arquivos criados / alterados

Arquivo	Ação	Descrição
docs/site/firebase.json	Criado	Configura o Firebase Hosting: diretório dist/, cleanUrls, headers de cache e segurança
docs/site/.firebaserc	Criado	Referência ao projeto Firebase (substituir SEU-PROJETO-ID-AQUI)
docs/site/astro.config.mjs	Alterado	Adicionado site: com URL do Firebase Hosting (habilita sitemap)
docs/site/.gitignore	Alterado	Adicionado .firebase/ para não versionar cache de deploy
scripts/deployDocs.ps1	Criado	Script PowerShell completo: instala deps, build e deploy com verificação de erros

Passo a passo para primeiro deploy

# 1. Instalar Firebase CLI (uma vez)
npm install -g firebase-tools

# 2. Autenticar (abre browser)
firebase login

# 3. Criar projeto no Firebase Console (https://console.firebase.google.com)
#    Anotar o Project ID gerado

# 4. Substituir o placeholder nos dois arquivos:
#    - docs/site/.firebaserc  →  "default": "meu-projeto-id"
#    - docs/site/astro.config.mjs  →  site: 'https://meu-projeto-id.web.app'

# 5. Executar o deploy
.\scripts\deployDocs.ps1

URLs do projeto

URL	Tipo
https://docs.sinergia.dev.br	Domínio principal (customizado)
https://sinergia-5241f.web.app	Firebase padrão
https://sinergia-5241f.firebaseapp.com	Firebase alternativo

O Firebase Hosting serve os três domínios simultaneamente após configurar o domínio customizado no console.