Firebase CLI Release Notes

To use the Firebase CLI in your development environment, see Set up or update the Firebase CLI.

Version 13.7.1 - April 05, 2024

  • Fixed an issue where the functions emulator would choose the wrong runtime if none was listed in firebase.json. (#6965)

Version 13.7.0 - April 04, 2024

  • Added new 2nd gen Cloud Firestore triggered functions with Authentication context. (#1519)
  • Added (opt-out) experiment to disable cleaning up containers after a functions deploy. (#6861)
  • Fixed Next.js image optimization check in app directory for Windows. (#6930)
  • Added support for next.config.mjs. (#6933)
  • Removed development-only files from Next.js deployments. (#6731)

Version 13.6.1 - April 02, 2024

  • Stop trying to delete cache images that Google Cloud Functions already cleans up. (#6927)
  • Add support timelines for functions runtimes. (#6866)

Version 13.6.0 - March 26, 2024

  • Released Cloud Firestore emulator 1.19.4. This version fixes a minor bug with reserve IDs and adds a reset endpoint for Datastore mode.
  • Released Pub/Sub emulator 0.8.2. This version includes support for no_wrapper options.
  • Fixed an issue where GitHub actions service account couldn't add preview URLs to authorized domains. (#6895)
  • Fixed an issue where GOOGLE_CLOUD_QUOTA_PROJECT broke functions source uploads. (#6917)

Version 13.5.2 - March 19, 2024

  • Fixed an issue where hosting rewrites failed when skipping functions. (#6658)

Version 13.5.1 - March 14, 2024

  • Released Emulator Suite UI v1.11.8 which adds support for multiple Cloud Firestore databases in the Emulator UI by editing the URL. (#6874)

Version 13.5.0 - March 13, 2024

  • Enabled dynamic debugger port for functions, in addition to support for inspecting multiple codebases. (#6854)
  • Injected an environment variable in the node functions emulator to tell the google-gax SDK not to look for the metadata service. (#6860)
  • Released Firestore Emulator 1.19.3 which fixes ancestor and namespace scope queries for Datastore Mode, as well as internal errors seen across the REST API and firebase-js-sdk.
  • Fixed v2 scheduled and event functions so that if a function has an explicit service account then its Eventarc triggers will use that service account. (#6858 and #6859)

Version 13.4.1 - March 07, 2024

  • Released Cloud Firestore emulator v1.19.2, which fixed some bugs affecting client SDKs when in Datastore mode. (#6827)
  • Fixed an issue with using demo projects and web frameworks together in the emulator suite. (#6737)
  • Fixed Next.js static routes with server actions. (#6664)
  • Fixed an issue where GOOGLE_CLOUD_QUOTA_PROJECT was not correctly respected. (#6801)
  • Fixed an issue where VPC egress settings in functions could not be parameterized. (#6843)

Version 13.4.0 - February 27, 2024

  • Added new commands for managing Cloud Firestore backups and restoring databases. (#6778)
  • Fixed quota attribution for Firebase Authentication API calls. (#6819)

Version 13.3.1 - February 21, 2024

  • Released Cloud Firestore emulator v1.19.1, which adds preview support for Datastore Mode to the Cloud Firestore emulator.
  • Fixed issue where GitHub actions would fail due to lack of permissions. (#6791)

Version 13.3.0 - February 14, 2024

  • Added support for Python 3.12 functions. (#6679)
  • Improved detection for when login has expired due to Google Cloud Session Control. (#1846)
  • Fixed issues with internal utilities. (#6754)
  • Fixed an issue where firestore:delete didn't target the emulator when expected. (#6537)

Version 13.2.1 - February 07, 2024

  • Fixed an issue where appdistribution:distribute would always attempt to run tests. (#6749)

Version 13.2.0 - February 06, 2024

  • Added rudimentary email enumeration protection for Authentication emulator. (#6702)
  • Added support for customized automated tests to appdistribution:distribute, with the automated tester feature (beta). To learn how to run an automated test, see Run an automated test for Android apps. (#6730)

Version 13.1.0 - January 24, 2024

  • Switched v2 function target to entrypoint. (#6698)
  • Fixed issue where Authentication emulator for sign in with Google only shows default tenant. (#6683)
  • Blocked the use of pinTags + minInstances on the same function, since the features do not work together. (#6684)
  • Added force flag to delete backend. (#6635)
  • Use framework build target in Vite builds. (#6643)
  • Use framework build target in NODE_ENV for production Vite builds. (#6644)
  • Let framework handle public directory with emulator. (#6674)
  • Fixed deprecated CJS build warning by dynamically importing Vite. (#6660)
  • Fixed unsafe array spreads on Hosting deploys. (#6712)

Version 13.0.3 - January 07, 2024

  • Fixed typo in Cloud Storage bucket metadata location type. (#6648)
  • Fixed an issue where including export in .env files caused parsing errors. (#6629)

Version 13.0.2 - December 17, 2023

  • Fixed Next.js dynamic and static OG images. (#6592)
  • Addressed a regression introduced in 13.0.1 of the CLI when emulating Vite applications. (#6599)
  • Added RSC headers of Next.js app directory pages to Hosting headers. (#6608)

Version 13.0.1 - December 07, 2023

  • Fixed bug where deploying Firestore triggered functions resulted in redundant API calls to the Firestore API. (#6583)
  • Fixed an issue preventing Vite applications from being emulated on Windows. (#6411)
  • Fixed an issue preventing Astro applications from being deployed from Windows. (#5709)
  • Fixed an issue preventing Angular apps using ng-deploy` from being emulated or deployed. (#6584)
  • Added warning if a web framework is outside the known supported range on deploy/emulate. (#6562)
  • Switched to using web framework's known supported version range in firebase init hosting. (#6562)
  • Permitted use of more SSR regions in web frameworks deploys. (#6086)
  • Limited web framework's generated function name to 23 characters, fixing deploys for some. (#6260)
  • Allowed Nuxt as an option during firebase init hosting. (#6309)

Version 13.0.0 - December 06, 2023

  • Breaking change: Dropped support for running the CLI on Node.js v16.
  • Breaking change: Removed deprecated ext:dev:publish command. Use ext:dev:upload instead.
  • Breaking change: Refactored functions:shell to remove its dependency on a deprecated request module.
    • As part of this change, removed support for some rarely used features of request.
  • Added support for running the CLI on Node.js v20.
  • Added force flag call-out for bypassing prompts. (#6506)
  • Added the ability to deploy Angular apps using the new application-builder. (#6480)
  • Switched Storage deployment to use GetDefaultBucket endpoint to fetch the default Storage bucket. (#6467)
  • Fixed an issue with emulating blocking functions when using multiple codebases. (#6504)
  • Fixed an issue where the --non-interactive flag was not respected in deploys of Firestore indexes. (#6539)
  • Fixed an issue where login:use would not work outside of a Firebase project directory. (#6526)
  • Fixed to prevent app router static not-found requiring a Cloud Function in Next.js deployments. (#6558)
  • Fixed to use only site ID from site name in list versions API. (#6565)

Version 12.9.1 - November 15, 2023

  • Fixed an issue where initializing Hosting failed when selecting a project. (#6527)

Version 12.9.0 - November 14, 2023

  • Added logic to create a Hosting site when one is not available in a project.
  • Added checks for the default Hosting site when one is assumed to exist.
  • Added force flag call-out for bypassing prompts. (#6506)
  • Reverted enabling preferRest by default to avoid performance degradations for some users. (#6520)
  • Fixed blocking functions in the emulator when using multiple codebases. (#6504)
  • Fixed an issue where the functions emulator did not respect the --log-verbosity flag. (#2859)

Version 12.8.0 - October 31, 2023

  • Enabled preferRest option by default for Firestore triggered functions. (#6147)
  • Fixed a bug where redeploying a Firestore triggered function (2nd gen) failed after updating secrets. (#6456)
  • Fixed a bug where similarly named Hosting channels caused issues when updating authorized domains. (#6356)

Version 12.7.0 - October 11, 2023

  • Added support for point-in-time recovery (PITR) on Cloud Firestore databases, including enabling, disabling, and displaying enablement state. (#6388)
  • Added a --log-verbosity flag to emulators:* commands that limits what logs are printed. (#2859)
  • Fixed type mismatch for parameterized function region. (#6205)
  • Ignore FIRESTORE_EMULATOR_HOST environment variable on functions deployment. (#6442)
  • Fixed an issue where params were not resolved when used to set VPC connector during functions deployment. (#6327)

Version 12.6.2 - October 04, 2023

  • Fixed an issue with deploying multi-level grouped functions containing 2nd gen functions. (#6419)
  • Fixed an issue where functions deployment required a new permission. (#6425)

Version 12.6.1 - September 27, 2023

  • Fixed an issue where the functions service account option was not treated as a param. (#6389)
  • Fixed an issue with deploying function groups containing 2nd gen functions. (#6408)
  • Changed to use the GetDefaultBucket endpoint to fetch the default Cloud Storage bucket.

Version 12.6.0 - September 26, 2023

  • Improved performance and reliability when deploying multiple 2nd gen functions using single builds. (#6376)
  • Fixed an issue where emulators:export did not check if the target folder is empty. (#6313)
  • Fixed an issue where retry could not be set for event-triggered functions. (#6391)
  • Fixed "Could not find the next executable" on Next.js deployments. (#6372)
  • Fixed issues caused by breaking changes in Next >=v13.5.0. (#6382)

Version 12.5.4 - September 12, 2023

  • Released Cloud Firestore emulator v1.18.2.
  • Removed nano precision in timestamp used in Cloud Firestore emulator (#5893)
  • Fixed a bug where Cloud Firestore emulator query behaved differently from production.
  • Fixed an issue where very long command outputs would be cut off. (#3286)

Version 12.5.3 - September 08, 2023

  • Fixed an issue where builds from firebase.tools could not run commands that spawn npm. (#6132)
  • Fixed an issue where --non-interactive and --force were not respected in some extension deploys. (#6321)
  • Fixed the regex in Extensions changelog parser to lazy match the version prefix to allow matching higher versions. (#6326)

Version 12.5.2 - August 24, 2023

  • Fixed an issue that caused unexpected behavior and errors when deploying functions. (#6290)

Version 12.5.1 - August 23, 2023

  • Fixed issue where deploys with a mix of 1st and 2nd gen functions would fail. (#6293)

Version 12.5.0 - August 22, 2023

  • Fixed issue where the Extensions emulator would error when emulating local extensions with no params. (#6271)
  • Fixed issue where next.config.js would not be bundled correctly. (#6287)
  • Improved performance and reliability when deploying multiple 2nd gen functions using single builds. (#6275)

Version 12.4.8 - August 15, 2023

  • Increased Cloud Functions emulator HTTPS body size limit to 32mb to match production. (#6201)
  • Fixed Astro web framework bug when loading configuration for version 2.9.7 and above. (#6213)
  • Increased Next.js config bundle timeout to 60 seconds. (#6214)

Version 12.4.7 - August 02, 2023

  • Improved error message raised when firebase init hosting:github fails due to max number of keys limit for a service account. (#6145)
  • Fixed bug where functions:secrets:\* family of commands did not work when Firebase CLI is authenticated via GOOGLE_APPLICATION_CREDENTIALS. (#6190)
  • Fixed bug where some extension instance updates would default to the wrong location. (#6202)

Version 12.4.6 - July 25, 2023

  • Fixed an issue where extension instances could not be deployed when authenticated as a service account. (#6060)
  • Fixed glob usage in Next.js utility function to detect images in app directory (#6166)
  • Allow experiments set with firebase experiments:enable to be accessed by the emulator UI. (#6169)

Version 12.4.5 - July 19, 2023

  • Fixed bug where functions:secrets:set didn't remove stale versions of a secret. (#6080)
  • Fixed bug where firebase deploy --only firestore:named-db didn't update rules. (#6129)
  • Fixed issue where Flutter Web wasn't detected as a web framework. (#6085)
  • Added better messages for API permissions failures, which now direct the user to the URL to enable the API. (#6130)
  • Fixed issue caused by adding stricter type checks. (#5906)
  • Fixed next/image component in app directory for Next.js > v13.4.9. (#6143)
  • Fixed bug where Next.js Image Optimization in the app directory wasn't requiring a Cloud Function. (#6143)
  • Fixed a transitive dependency on a vulnerable version of vm2. (#6150)

Version 12.4.4 - July 12, 2023

  • Disabled KeepAlive timeout when debugger is attached to the Cloud Functions emulator. (#6069)
  • Fixed an issue where database:list would have inaccurate results. (#6063)

Version 12.4.3 - July 06, 2023

  • Fixed incorrect links in firebase open hosting and firebase open crash. (#6073)
  • Released Firebase Emulator UI v1.11.7, which includes preview support for multiple Cloud Firestore database instances. (#6079)

Version 12.4.2 - June 28, 2023

  • Fixed an issue where lifecycle hooks did not run when functions were specified via --only functions:functionName. (#6023)
  • Increased extension instance create poll timeout to 1h to match backend. (#5969)
  • Refactored ext:install to use the latest extension metadata. (#5997)
  • Added descriptive error when repo is private or not found during ext:dev:upload. (#6052)
  • Fixed issue where missing trigger warnings would be wrongly displayed when emulating extensions with HTTPS triggers. (#6055)
  • Normalized extension root path before usage in ext:dev:upload. (#6054)

Version 12.4.1 - June 27, 2023

  • Released Cloud Firestore emulator 1.18.1, which adds an emulator configuration to start in experimental mode. (#5942)
  • Fixed an issue where lifecycle hooks would not run when codebases were specified via --only. (#6011)
  • Fixed an issue causing firebase emulators:start to crash on Next.js apps. (#6005)

Version 12.4.0 - June 15, 2023

  • Fixed an issue where Cloud Storage Security Rules could not be deployed to projects without a billing plan. (#5955)
  • Added appdistribution:group:create and appdistribution:group:delete. (#5978)
  • Added --group-alias option to appdistribution:testers:add and appdistribution:testers:remove. (#5978)

Version 12.3.1 - June 06, 2023

  • Delete and re-create v2 function on Cloud Run API quota exhaustion.
  • Changed firebase functions:secrets:* to ensure the Secret Manager API is enabled.

Version 12.3.0 - June 01, 2023

  • Fixed a bug that prevented web framework's dev-mode from working out-of-box with Firebase Authentication.
  • Addressed additional cases where the CLI was attempting to deploy a framework's development bundle.
  • Fixed an issue where Next.js rewrites were not prefixed with the basePath defined in next.config.js.
  • Fixed an issue where web frameworks emulators were not respecting existing Cloud Functions rewrites.
  • Web frameworks rewrites/redirects/headers will only prepend those in firebase.json if there's a baseUrl.
  • Fixed an issue where Authentication emulator created a user if empty email and empty password was provided.
  • Improved error message raised when --import flag directory does not exist.
  • Switched ext:dev:init to default billingRequired to true in extension.yaml.
  • Removed LOCATION param from the extensions.yaml template for ext:dev:init.
  • Added support for Astro hybrid rendering.

Version 12.2.1 - May 24, 2023

  • Fixed an issue where rules runtime would not gracefully close when the Cloud Storage emulator stopped.
  • Changed firebase deploy to always assume build target of production for a web framework, unless overridden.

Version 12.2.0 - May 23, 2023

  • Updated error message when function deploy fails due to quota.
  • Fixed Realtime Database emulator 127.0.0.1 namespace resolution bug.
  • Improved Realtime Database emulator to Cloud Functions emulator network reliability.
  • Allowed for Angular developers to both target a PWA and leverage serveOptimizedImages.
  • Fixed an issue where multi-page applications that are fully statically rendered were treated as PWAs.
  • Fixed an issue where ssr: false and baseURL were not respected when using Nuxt.
  • Fixed an issue where the JS SDK auto-init was not working for Vite while in dev-mode (#5610).
  • Fixed an issue where FIREBASE_FRAMEWORKS_BUILD_TARGET environment variable would not override the default build target.
  • Improved cleanup process when reloading emulated functions in debug mode.
  • Added support for Node.js v20 for web frameworks.
  • Added fast dev-mode support for developers using Nuxt v2.

Version 12.1.0 - May 19, 2023

  • Improved error handling while building web frameworks.
  • Added support for Node.js v20 for Cloud Functions for Firebase.
  • Added Flutter for web as an option in firebase init hosting.

Version 12.0.1 - May 16, 2023

  • Fixed an issue in the Eventarc emulator where events missing optional fields was causing crashes.
  • Fixed an issue when running firebase emulators:start and firebase deploy if Python Cloud Functions directory path has spaces.

Version 12.0.0 - May 9, 2023

  • Changed hosting.frameworksBackend to respect omit: true.
  • Fixed an issue where the backend requirement was not tripped for Angular applications using ng-deploy with serveOptimizedImages.
  • Fixed an issue where the Cloud Storage emulator would not fall back to open rules for demo- projects if firebase.json contained multiple Cloud Storage targets.
  • Dropped support for running the CLI on Node.js v14.
  • Updated firebase init function templates for TypeScript and Javascript to 2nd gen.
  • Added support for atomic deployment of Hosting content and Cloud Functions rewrites via tag pinning.
  • Changed web frameworks to memoize framework builds for single builds across multiple hosting sites.
  • Added support for Angular i18n and baseHref. (#5774)
  • Added support for Next.js i18n, basePath, and more advanced rewrites/redirects/headers.
  • Added ext:dev:* commands to publish and manage Extensions. For step-by-step instructions on how to publish your own Extensions, see the publisher documentation.

Version 11.30.0 - May 3, 2023

  • Added more helpful error messages for the Firebase Hosting GitHub Action.
  • Upgraded the Cloud Firestore emulator to v1.17.4.
  • Changed web frameworks to no longer try to deploy unsupported versions of Node.js to Cloud Functions.
  • Fixed an issue where emulators would not start correctly due to corrupted ZIP files.
  • Released Emulator Suite UI v1.11.6.
  • Improved experience for developers using Next.js v13's app directory.
  • Fixed an issue where timeout would not resolve when bundling Next.js applications for Cloud Functions.
  • Fixed an issue where the Cloud Functions emulator would attempt to call to prod for demo- projects.
  • Addressed issues starting the Hosting emulator with some versions of Next.js.
  • Fixed regex page matcher for Next.js middlewares v1.
  • Fixed an issue where the Cloud Functions emulator broke when client request disconnects.
  • Added experimental support for deploying Flutter Web applications. to Firebase Hosting
  • Added Cloud Functions emulator support for Cloud Firestore (2nd gen) triggers.

Version 11.29.1 - April 26, 2023

  • Fixed an issue that prevented local extension instances from being updated to uploaded versions.
  • Released Cloud Firestore emulator v1.17.3.

Version 11.29.0 - April 25, 2023

  • Released Cloud Firestore emulator v1.17.2. This change propagates page token from ListDocumentsResponse to GetOrListDocumentsResponse in the Cloud Firestore emulator.
  • Fixed an issue where Secret Manager secrets were tagged incorrectly. (#5704)
  • Fixed an issue where Custom Event channels weren't automatically created on function deploys.
  • Removed Cloud Functions 2nd gen naming restrictions.
  • Fixed an issue where ext:install and ext:configure would error on extensions with no params.
  • Fixed an issue with Vite and Angular integrations using an obsolete npm command.

Version 11.28.0 - April 18, 2023

  • Relaxed repo URI validation in ext:dev:publish.
  • Enabled Secret Manager API during ext:install and ext:update for extensions that use secrets.
  • Added extensions as an option in firebase init.
  • Added the following new commands for provisioning and managing Cloud Firestore database instances:
    • firestore:databases:list
    • firestore:databases:create
    • firestore:databases:get
    • firestore:databases:update
    • firestore:databases:delete
    • firestore:locations

Version 11.27.0 - April 13, 2023

  • Fixed broken experience for projects with incomplete 2nd Gen Cloud Functions.
  • Disabled Cloud Functions breaking change to automatically run npm build scripts as part of function deploy.
  • Added experimental support for deploying Astro applications to Firebase Hosting.
  • Changed emulators:start to default to fast dev-mode for Nuxt3 applications.

Version 11.26.0 - April 11, 2023

  • Fixed an issue where functions shell failed to invoke event-triggered functions in debug mode.
  • Fixed an issue with the web frameworks proxy that could see unexpected 404 errors while emulating.
  • Forced Vite to build the production bundle when deploying to Firebase Hosting.
  • Fixed an issue that prevented deploying Cloud Functions that imported firebase-tools as a library.
  • Added experimental support for SvelteKit codebases.
  • Added support for using of Angular and Vite within an npm workspace.
  • Added ability to publish extension versions directly from GitHub.