Download Latest Version 21.0.0 source code.zip (1.9 MB)
Home / 21.0.0
Name Modified Size InfoDownloads / Week
Parent folder
21.0.0 source code.tar.gz 2026-10-26 1.7 MB
21.0.0 source code.zip 2026-10-26 1.9 MB
README.md 2026-10-26 11.0 kB
Totals: 3 Items   3.6 MB 0

Upgrading from AngularFire 20

AngularFire 21 requires Angular 21.2 or newer, firebase 12.18.0 or newer, rxfire 6.2.0 or newer, and TypeScript 5.8 or newer (below 6). ng add and ng deploy work with firebase-tools 14 or 15.

ng update @angular/core@21 @angular/cli@21 @angular/fire

The AngularFire 21 upgrade guide covers the rest, including the Vertex AI to Firebase AI Logic move.

Update firebase together with @angular/fire. If your package.json still requests firebase 11, npm does not report a conflict. It installs both SDK versions side by side, and the two copies reject each other's objects at runtime. ng update @angular/fire@21 moves your firebase dependency to ^12.18.0 for you. If you upgrade by hand, run npm install firebase@^12 with it, then check that npm ls firebase shows one version.

Breaking changes

  • Angular 21.2 or newer is required (#3763). Angular 21 is in long-term support, so 21.2 is its final minor line. Run ng update @angular/core @angular/cli first if your app is on 21.0 or 21.1.
  • firebase 12.18.0 or newer and rxfire 6.2.0 or newer are required (#3761, [#3723]). Older rxfire versions ask for firebase 11, which installs a second SDK copy next to your firebase 12.
  • The @angular/fire/vertexai entry point is gone. Its replacement is @angular/fire/ai, Firebase AI Logic (#3674). ng update @angular/fire@21 rewrites the imports and renamed symbols, emits AgentPlatformBackend in place of the deprecated VertexAIBackend, and changes the default location from us-central1 to global, warning for every file whose region changed (#3725, [#3762]). The Imagen API, removed in firebase 12.18, is no longer wrapped, and the migration warns remaining Imagen users (#3750).
  • App Check no longer runs during server rendering by default (#3773). AngularFire no longer calls the function passed to provideAppCheck on the server, and inject(AppCheck) returns null there. Browser-side behavior is unchanged. This fixes the ReferenceError: document is not defined build failure in server-rendered apps, because the reCAPTCHA providers need a browser. To keep App Check running during server rendering, provide APP_CHECK_ON_SERVER as true in your server config:

```ts import { APP_CHECK_ON_SERVER } from '@angular/fire/app-check';

// in your server app config's providers { provide: APP_CHECK_ON_SERVER, useValue: true }, ```

Details, including how server-side Firebase requests can still carry an App Check token: App Check during server rendering.

Updating from a 21 release candidate or canary build

Installing a release candidate saves its exact version, so it does not move on its own (#3709). Run:

ng update @angular/fire@21

If you installed a canary build, run npm install @angular/fire@latest instead. ng update does not offer 21.0.0 to a 21.0.1-canary install, because the canary's version number is higher.

What's Changed

Fixes that also shipped to Angular 20 apps in 20.0.3, 20.1.0 and 20.1.1 are not repeated here.

Upgrading to v21

Setting up (ng add)

Deploying (ng deploy)

  • fix: ng deploy no longer crashes on launch with ERR_INVALID_ARG_TYPE. The schematics ship as a CommonJS bundle, which turned the code's import.meta lookup into undefined before it reached any real work. by @armando-navarro in https://github.com/angular/angularfire/pull/3729
  • fix: declare the three packages the schematics require at runtime (jsonc-parser, @angular-devkit/core, @angular-devkit/architect). The published package.json never listed them, so ng deploy failed to resolve modules under pnpm's default layout and Yarn Plug'n'Play. by @armando-navarro in https://github.com/angular/angularfire/pull/3747

Server-side rendering

Documentation

Sample app

  • chore: the sample app runs on Angular 21 as the v21 CLI generates it (zoneless change detection, incremental hydration, Express 5), with a working Cloud Functions demo on Node 22. by @markgoho in https://github.com/angular/angularfire/pull/3671

New Contributors

Thanks to everyone who tested the release candidates and reported issues. The reports on [#3684], [#3681] and [#3682] are what identified the duplicated-SDK cause, and they are why ng update corrects it for you.

Full Changelog: https://github.com/angular/angularfire/compare/20.1.1...21.0.0

Source: README.md, updated 2026-10-26