O Firebase App Hosting foi projetado especificamente para oferecer suporte ao desenvolvimento de apps da Web modernos centrados em framework. Use esta página como referência para as ferramentas e frameworks que App Hosting oferece suporte direto, além de um ponto de partida para saber mais sobre frameworks e ferramentas relacionadas.
Frameworks da Web e App Hosting
O App Hosting oferece dois níveis amplos de suporte para frameworks modernos da Web: suporte pré-configurado para build e implantação e suporte no nível da comunidade por meio de contribuições de código aberto que obedecem à especificação do pacote de saída. Em ambos os casos, um componente de adaptador de framework permite a integração de um framework específico com App Hosting.
Frameworks com suporte pré-configurado para build e implantação
Com o suporte pré-configurado para build e implantação, o Firebase identifica qual
framework você está usando ao inspecionar o arquivo package-lock.json ou outro arquivo
de bloqueio e otimiza os processos de build e implantação para o app. O Google se
compromete a manter o suporte a esses frameworks, e a equipe de suporte
do Firebase pode aceitar relatórios de problemas e solicitações de recursos.
Esse nível de suporte é fornecido para:
- Next.js
- Angular
Consulte as programações de suporte para conferir detalhes sobre versões e níveis de suporte específicos.
Se você tentar implantar um app Node.js que não tem um arquivo de bloqueio, o App Hosting
não vai conseguir criar e executar o app. É possível criar package-lock.json executando
npm install no diretório raiz.
Frameworks com suporte da comunidade
Além do Next.js e do Angular, o App Hosting também oferece suporte a qualquer framework da Web que possa fornecer uma saída de build que corresponda à nossa especificação de pacote de saída. Os autores de frameworks podem aproveitar a especificação do pacote de saída para garantir que o framework tenha suporte ao App Hosting. Por exemplo, o popular framework Nuxt tem suporte da equipe do Nitro, que criou um adaptador do Firebase para permitir a implantação de apps Nuxt no App Hosting.
Se você quiser conferir outros frameworks com suporte ao App Hosting, crie um adaptador de framework ou entre em contato com os mantenedores do framework para converter as saídas de build no formato App Hosting. Os adaptadores do Next.js e do Angular são bons exemplos de referência para qualquer pessoa que esteja criando um adaptador.
Informações sobre frameworks com suporte da comunidade podem ser encontradas em Firebase Open Source. Problemas e solicitações de recursos para frameworks com suporte da comunidade devem ser direcionados à comunidade de código aberto ou aos autores do framework. Em alguns casos, o Google pode ajudar, mas a comunidade é a primeira linha de suporte para esses adaptadores.
Adaptadores de framework App Hosting
No App Hosting, o suporte a frameworks pré-configurados e com suporte da comunidade é fornecido por adaptadores de framework. Os adaptadores do framework App Hosting têm duas funções principais:
- Eles analisam o código-fonte e qualquer arquivo de configuração específico do framework (como
next.config.js) e geram um pacote de saída que pode ser processado pelo resto da infraestrutura App Hosting. - Eles executam o comando de build do app para gerar recursos estáticos e criar uma versão otimizada do app para produção.
Os adaptadores de framework criam seu app Node.js com npm run build, funcionando melhor
com os scripts de build padrão de cada framework: next build para Next.js e
ng build para Angular. O App Hosting vai tentar criar com comandos de build
personalizados, mas não pode garantir o sucesso. É possível
substituir scripts de build e execução
em apphosting.yaml.
A origem dos adaptadores do Next.js e do Angular está disponível em firebase-framework-tools.
Ambientes de execução para App Hosting
Depois de ser criado e lançado por App Hosting, o app Node.js é executado em uma revisão Cloud Run. Portanto, a versão do ambiente de execução do app precisa estar dentro do intervalo de suporte de Cloud Run e do framework da Web escolhido. Para o suporte pré-configurado para Angular e Next.js, isso significa que as seguintes versões do Node.js são compatíveis:
- Next.js 13.5.x e versões mais recentes
- Angular 18.2.x e versões mais recentes
- Node.js 18 e versões mais recentes
O App Hosting não oferece suporte ativo automático para versões de framework recém-lançadas. As versões mais recentes do que a versão "ativa" designada atualmente serão consideradas em um estado de "pré-visualização" até serem marcadas oficialmente como "ativas" para App Hosting.
O App Hosting oferece suporte de longo prazo (LTS) para a versão secundária mais recente de uma versão principal por um ano a partir do período de suporte ativo, desde que você faça atualizações consistentes para as versões de patch mais recentes nessa versão secundária. Consulte as tabelas a seguir para detalhes sobre o Next.js e o Angular.
Cronograma de suporte do Next.js
| Versão | Status | Suspensão de uso |
|---|---|---|
| 13.5.x | lts | 2026-10-9 |
| 14.2.x | lts | 2026-10-9 |
| 15.0.x | ativo | Não antes de 9 de outubro de 2025 |
| 15.1.x | ativo | Não antes de 9 de outubro de 2025 |
| 15.2.x | ativo | - |
Cronograma de suporte do Angular
| Versão | Status | Suspensão de uso |
|---|---|---|
| 18.2.x | lts | 2026-10-9 |
| 19.0.x | ativo | Não antes de 9 de outubro de 2025 |
| 19.1.x | ativo | Não antes de 9 de outubro de 2025 |
| 19.2.x | ativo | - |
Gerenciadores de pacotes
O App Hosting usa buildpacks nativos da nuvem para executar a instalação de dependências e cria o app usando npm, yarn ou pnpm. Outros gerenciadores de pacotes, como o JSR, não são compatíveis.
NPM
- O NPM é o gerenciador de pacotes padrão.
- As dependências que não são de produção são podadas após o build ser concluído.
- É possível especificar a seção da versão do NPM usando o campo
engines.npmno arquivopackage.json.
Lã
- O Yarn é usado quando você inclui o arquivo
yarn.lockno projeto. - É possível especificar a versão do Yarn a ser usada no campo
engines.yarnoupackageManagerdo arquivopackage.json. - O App Hosting oferece suporte ao modo Yarn2 PnP.
Pnpm
- O Pnpm é usado quando você inclui o arquivo
pnpm-lock.yamlno projeto. - Você pode especificar uma versão do pnpm no campo
engines.pnpmoupackageManagerdo arquivopackage.json. - Para um exemplo prático, consulte o sample-node-pnpm. do app.
Monorepos para App Hosting
O App Hosting oferece suporte a apps baseados em Nx. Consulte Usar monorepos com App Hosting para orientações detalhadas.
As seguintes versões do Nx são compatíveis:
| Versão | Status | Suspensão de uso |
|---|---|---|
| 19.5.x | manutenção | 2025-10-9 |
| 19.6.x | manutenção | 2025-10-9 |
| 19.7.x | manutenção | 2025-10-9 |
| 19.8.x | lts | 2026-10-9 |
| 20.0.x | ativo | Não antes de 9 de outubro de 2025 |
| 20.1.x | ativo | Não antes de 9 de outubro de 2025 |
| 20.2.x | ativo | Não antes de 9 de outubro de 2025 |
| 20.3.x | ativo | Não antes de 9 de outubro de 2025 |
| 20.4.x | ativo | Não antes de 9 de outubro de 2025 |
| 20.5.x | ativo | Não antes de 9 de outubro de 2025 |
| 20.6.x | ativo | Não antes de 9 de outubro de 2025 |
| 20.7.x | ativo | — |
Se você precisar de suporte para outros tipos de espaços de trabalho monorepo, entre em contato com a Firebase UserVoice.