Firebase App Hosting está diseñado específicamente para admitir el desarrollo moderno de apps web centrado en el framework. Usa esta página como referencia de las herramientas y los marcos de trabajo que App Hosting admite directamente, así como un punto de partida para obtener información sobre los marcos de trabajo y las herramientas relacionados.
Frameworks web y App Hosting
App Hosting proporciona dos niveles amplios de asistencia para frameworks web modernos: asistencia de compilación y, luego, implementación preconfigurada, y asistencia a nivel de la comunidad a través de contribuciones de código abierto que se ajustan a la especificación del paquete de salida. En ambos casos, un componente de adaptador de framework habilita la integración de un framework específico con App Hosting.
Frameworks con compatibilidad preconfigurada para la compilación y la implementación
Con la compatibilidad preconfigurada para la compilación y la implementación, Firebase identifica cuál
es el framework que usas mediante la inspección del archivo package-lock.json o de otro archivo
de bloqueo, y optimiza los procesos de compilación y de implementación de tu app. Google se
compromete a mantener la compatibilidad con estos frameworks, y el equipo de asistencia
de Firebase puede aceptar informes de problemas y solicitudes de funciones.
Este nivel de asistencia se proporciona para lo siguiente:
- Next.js
- Angular
Consulta los programas de asistencia para obtener detalles sobre las versiones y los niveles de asistencia específicos.
Si intentas implementar una app de Node.js a la que le falta un archivo de bloqueo, App Hosting no compilará ni ejecutará tu app. Para crear package-lock.json, ejecuta npm install en tu directorio raíz.
Frameworks con asistencia comunitaria
Además de Next.js y Angular, App Hosting también admite cualquier framework web que pueda proporcionar un resultado de compilación que coincida con nuestra especificación de paquete de salida. Los autores de frameworks pueden aprovechar la especificación del paquete de salida para asegurarse de que App Hosting admita su framework. Por ejemplo, el popular framework de Nuxt es compatible con el equipo de Nitro, que creó un adaptador de Firebase para habilitar la implementación de apps de Nuxt en App Hosting.
Si deseas ver frameworks adicionales compatibles con App Hosting, puedes crear un adaptador de framework o comunicarte con los responsables del mantenimiento del framework para convertir los resultados de la compilación en el formato App Hosting. Los adaptadores de Next.js y Angular son buenos ejemplos de referencia para cualquier persona que cree un adaptador.
Puedes encontrar información sobre los frameworks compatibles con la comunidad en Código abierto de Firebase. Los problemas y las solicitudes de funciones para frameworks compatibles con la comunidad deben enviarse a la comunidad de código abierto o a los autores del framework. En algunos casos, Google puede ayudarte, pero la comunidad es la primera línea de asistencia para estos adaptadores.
Adaptadores de framework de App Hosting
En App Hosting, la compatibilidad con frameworks preconfigurados y compatibles con la comunidad se proporciona a través de adaptadores de framework. Los adaptadores del framework App Hosting tienen dos roles clave:
- Analizan tu código fuente y cualquier archivo de configuración específico del framework (como
next.config.js) y generan un paquete de salida que puede procesar el resto de la infraestructura de App Hosting. - Ejecutan el comando de compilación de tu app para generar recursos estáticos y crear una versión optimizada de tu app para producción.
Los adaptadores de framework compilan tu app de Node.js con npm run build, que funciona mejor con las secuencias de comandos de compilación predeterminadas de cada framework: next build para Next.js y ng build para Angular. App Hosting intentará compilar con comandos de compilación personalizados, pero no puede garantizar el éxito de forma confiable. Puedes anular las secuencias de comandos de compilación y ejecución en apphosting.yaml.
La fuente de los adaptadores de Next.js y Angular está disponible en firebase-framework-tools.
Entornos de ejecución para App Hosting
Después de que App Hosting la compila y lanza, tu app de Node.js se ejecuta en una revisión de Cloud Run. Por lo tanto, la versión del entorno de ejecución de tu app debe estar dentro del rango compatible con Cloud Run y del rango del framework web que elegiste. En el caso de la compatibilidad preconfigurada con Angular y Next.js, esto significa que se admiten las siguientes versiones de Node.js:
- Next.js 13.5.x y versiones posteriores
- Angular 18.2.x y versiones posteriores
- Node.js 18 y versiones posteriores
App Hosting no proporciona asistencia activa automáticamente para las versiones de framework que se lanzaron recientemente. Las versiones más recientes que la versión designada actualmente como "activa" se considerarán en un estado "de vista previa" hasta que se marquen oficialmente como "activas" para App Hosting.
App Hosting admite la asistencia a largo plazo (LTS) para la versión secundaria más reciente de una versión principal durante un año a partir de su período de asistencia activa, siempre que actualices de forma coherente a las versiones de parche más recientes de esa versión secundaria. Consulta las siguientes tablas para obtener detalles sobre Next.js y Angular.
Programa de asistencia de Next.js
| Versión | Estado | Baja |
|---|---|---|
| 13.5.x | lts | 2026-10-9 |
| 14.2.x | lts | 2026-10-9 |
| 15.0.x | activo | No antes del 9/10/2025 |
| 15.1.x | activo | No antes del 9/10/2025 |
| 15.2.x | activo | - |
Programa de asistencia de Angular
| Versión | Estado | Baja |
|---|---|---|
| 18.2.x | lts | 2026-10-9 |
| 19.0.x | activo | No antes del 9/10/2025 |
| 19.1.x | activo | No antes del 9/10/2025 |
| 19.2.x | activo | - |
Administradores de paquetes
App Hosting usa Cloud Native Buildpacks para ejecutar la instalación de dependencias y compilar la app con npm, yarn o pnpm. No se admiten otros administradores de paquetes, como JSR.
NPM
- NPM es el administrador de paquetes predeterminado.
- Las dependencias que no son de producción se eliminan después de que la compilación se realiza correctamente.
- Puedes especificar la sección de la versión de la Administración de socios de red mediante el campo
engines.npmen el archivopackage.json.
Lana
- En su lugar, se usa Yarn cuando incluyes el archivo
yarn.locken tu proyecto. - Puedes especificar la versión de yarn para usar en el campo
engines.yarnopackageManagerdel archivopackage.json. - App Hosting admite el modo PnP de Yarn2.
Pnpm
- Pnpm se usa en su lugar cuando incluyes el archivo
pnpm-lock.yamlen el proyecto. - Puedes especificar una versión de pnpm en el campo
engines.pnpmopackageManagerdel archivopackage.json. - Para ver un ejemplo funcional, consulta sample-node-pnpm. para tu app alojada en contenedores.
Monorepos para App Hosting
App Hosting admite apps basadas en Nx. Consulta Cómo usar monorepos con App Hosting para obtener una guía detallada.
Se admiten las siguientes versiones de Nx:
| Versión | Estado | Baja |
|---|---|---|
| 19.5.x | mantenimiento | 2025-10-9 |
| 19.6.x | mantenimiento | 2025-10-9 |
| 19.7.x | mantenimiento | 2025-10-9 |
| 19.8.x | lts | 2026-10-9 |
| 20.0.x | activo | No antes del 9/10/2025 |
| 20.1.x | activo | No antes del 9/10/2025 |
| 20.2.x | activo | No antes del 9/10/2025 |
| 20.3.x | activo | No antes del 9/10/2025 |
| 20.4.x | activo | No antes del 9/10/2025 |
| 20.5.x | activo | No antes del 9/10/2025 |
| 20.6.x | activo | No antes del 9/10/2025 |
| 20.7.x | activo | — |
Si necesitas asistencia para otros tipos de espacios de trabajo de monorepo, comunícate con nosotros en UserVoice de Firebase.