App Hosting Next.js Adapter

Official Next.js support for Firebase App Hosting.

Versions supported

Version Status Deprecation
13.5.x lts 2026-10-9
14.2.x lts 2026-10-9
15.0.x active not before 2025-10-9
15.1.x active not before 2025-10-9
15.2.x active -

See Firebase App Hosting's runtime support policy for more information.

Known limitations

  • By default, the built-in NextJS image optimization is disabled on App Hosting unless you explicitly set images.unoptimized to false or use a custom Image Loader. See Optimize image loading on Next.js.
  • URL paths containing percent-encoded characters are decoded by Cloud Run. This may cause issues with features that expect only encoded URL paths, such as Next.js parallel routing.
  • Currently, App Hosting limits the caching for NextJS apps using middleware. Over time, cache hit rates should improve.
  • URL paths containing percent-encoded characters are decoded by Cloud Run. This may cause issues with features that expect only encoded URL paths, such as Next.js parallel routing

See Firebase App Hosting's FAQ and troubleshooting documentation for up-to-date information on the current limitations of the platform.