AngularFire 22 targets Angular 22 and the Firebase JS SDK v12 or v13. Most of the upgrade is handled for you by ng update.
AngularFire 22 is a release candidate, published under the next tag. From an app on Angular 21 and AngularFire 21, run:
ng update @angular/core@22 @angular/cli@22 @angular/fire@nextInclude @angular/fire@next in the same command as Angular. On its own, ng update @angular/core@22 @angular/cli@22 refuses to run while AngularFire 21 is installed, because AngularFire 21 only accepts Angular 21.
The AngularFire update runs a migration that:
- Adds
firebaseto yourpackage.jsonif it is missing, and reinstalls. See the next section for why. - Aligns an existing
firebaseentry when it requests a version outside^12.18.0 || ^13.0.0, the range AngularFire 22 supports.
Either way, the migration writes ^13.0.0 when firebase 13 is already installed and ^12.18.0 otherwise, so an app on firebase 12 stays on 12 and an app on firebase 13 stays on 13.
Through AngularFire 21, @angular/fire listed firebase under dependencies, so npm could install a second copy of the SDK under node_modules/ whenever your app asked for a different version. The two copies reject each other's objects at runtime, with errors such as Expected type '_Query', but it was: a custom _CollectionReference object or toDate is not a function.
AngularFire 22 lists firebase under peerDependencies instead. So your app should declare firebase in its package.json (on Yarn it must, since Yarn installs no peer dependencies). This gives you exactly one copy of firebase. When your package.json requests an incompatible version, npm refuses to install it and Yarn and pnpm warn (see below), instead of the app failing at runtime.
ng update @angular/fire@next updates an older firebase entry in your package.json when it requests a version outside ^12.18.0 || ^13.0.0. If your app doesn't list firebase in package.json, the migration adds it and reinstalls. Verify with npm ls firebase, which should show exactly one copy.
Add the dependency yourself:
npm install @angular/fire@next firebase@^12.18.0npm 7 and later install a missing peer dependency automatically, so npm install @angular/fire@next alone also works, but it does not write firebase into your package.json. Declare it so that a later install cannot change which version you get.
An app that requests a firebase version outside the range AngularFire 22 supports now fails to install with an ERESOLVE error. Update your firebase entry to a version inside the range given in the error message, then install again:
npm install firebase@^12.18.0Do not use --force or --legacy-peer-deps to get past this message. Both install the older SDK next to AngularFire 22 and the runtime errors described above come back. If your project has legacy-peer-deps=true in its .npmrc, remove it before upgrading.
Yarn doesn't install peer dependencies. Add firebase to your own package.json as shown above, or run ng update @angular/fire@next, which adds it.
An older version installs anyway with a warning (has incorrect peer dependency "firebase@^12.18.0 || ^13.0.0" on Yarn 1, YN0060: INCOMPATIBLE_PEER_DEPENDENCY on Yarn 2+), so treat that warning as an upgrade step you still have to do.
pnpm 8 and later install a missing firebase automatically. An older version installs anyway with a warning (unmet peer firebase@"^12.18.0 || ^13.0.0": found 11.x on pnpm 9 and 10, Issues with peer dependencies found. Run "pnpm peers check" to list them. on pnpm 11 and 12), and pnpm prints that warning only once, when it first resolves the tree, never on a later install from the committed lockfile.
Set strict-peer-dependencies=true in .npmrc to make pnpm refuse the mismatch outright.
AngularFire 22 works with firebase 12 (^12.18.0) and firebase 13 (^13.0.0). ng update keeps the firebase major your app already has, so moving to firebase 13 is a separate step you can take when you are ready:
npm install firebase@^13.0.0Before you update, check these firebase 13 changes:
VertexAIBackendis removed fromfirebase/ai, and so from@angular/fire/ai. UseAgentPlatformBackend, which firebase 12.18 also exports, so you can switch before you upgrade.VertexAIBackenddefaults to theus-central1location andAgentPlatformBackendtoglobal, so replacenew VertexAIBackend()withnew AgentPlatformBackend('us-central1')to keep the same location.- A call that already passes a location keeps it as is.
- Node.js 24.12 or later. firebase 13's packages declare
"node": ">=24.12.0", so on Node.js 22 npm printsEBADENGINEwarnings when it installs them.
For everything else that changed, see the Firebase JavaScript SDK release notes.
@angular/fire no longer installs @angular-devkit/schematics, @angular-devkit/core or @schematics/angular. The Angular CLI supplies them when it runs ng add and ng update, so nothing changes for an Angular CLI or Nx workspace.
If you run AngularFire's schematics with the standalone schematics command on pnpm with hoist=false, add those three packages to your own package.json.
Deploying server-side rendering to Cloud Functions with ng deploy (a deploy target with ssr: true or ssr: 'cloud-functions', and the functionsRuntimeOptions and CF3v2 options only it reads) is deprecated in AngularFire 22 and will be removed in AngularFire 23. ng deploy prints a warning before the build when it runs in that mode. Server-rendered apps should move to Firebase App Hosting.
Hosting-only deploys (ssr absent or false) and Cloud Run deploys (ssr: 'cloud-run') are not deprecated. They no longer print the old "Legacy ng-deploy Firebase is deprecated" message.
Every Observable read (collectionData, docData, authState, user, objectVal, listVal and the rest) used to hand each value to your subscriber on a timer (setInterval with no delay), one event-loop turn later. It now does so at the next microtask checkpoint, which is sooner. The compat AngularFireAuth streams change the same way. What arrives, in which order, and when change detection runs do not change.
What an upgrading app may notice:
- A test that waits only for microtasks (a few awaited promises, vitest fake timers without advancing,
fakeAsyncwithflushMicrotasks()alone) now sees a value whose source emits in a microtask, as Auth and a promise-based mock do.- In a test that fakes timers, a Firestore value still arrives only after the clock is advanced with
tick()orvi.advanceTimersByTime(), because the Firestore SDK hands each snapshot over inside asetTimeout. - A test that already advances the clock, or waits for a real timer, sees the value exactly as before.
- In a test that fakes timers, a Firestore value still arrives only after the clock is advanced with
- Code that registers its own
setTimeoutwhen a read emits sees that timer run after the value arrives, not before. - In a zoneless server render, a value arriving between the app reporting stable and serialization now reaches a
TransferStateentry you write by hand but not the HTML, because the zoneless change-detection pass is itself a later timer.- Before this change such a value reached neither. AngularFire itself writes nothing into
TransferState.
- Before this change such a value reached neither. AngularFire itself writes nothing into
Every callback read (onSnapshot, onAuthStateChanged, onValue and the other callback-taking functions wrapped with a pending task) used to keep Angular's pending task for one more setTimeout(fn, 0) delay after its first callback ran, and again after unsubscribe. It now removes the task right after the callback body returns, and right after the unsubscribe call. What the callback receives, and when change detection runs, do not change.
ApplicationRef.whenStable()and a server render follow a callback read's first value onesetTimeout(fn, 0)delay sooner.- A test that inspects Angular's pending tasks sees the task gone as soon as the callback has run, with no timer to advance. A test that awaits
whenStable()under fake timers still needs the clock advanced, because Angular's own change-detection tick runs on a timer.
- Node.js 20 is not supported. Angular 22 requires Node.js
^22.22.3 || ^24.15.0 || >=26.0.0. Node.js 20 reached end of life on 2026-04-30. - TypeScript 6.0 is required (AngularFire 22 peers
typescript >=6.0 <6.1). TypeScript 6 turnsstricton by default, dropsdownlevelIterationand deprecatesbaseUrlandmoduleResolution: "node", so an app carrying those settings in itstsconfig.jsonmay see new compiler errors that Angular's own update does not fix. - Coming from a 21 release candidate (
21.0.0-rc.0,rc.1orrc.2), the v21 migration runs once more and reports "No changes made", because21.0.0lies between your version and22.0.0. That is expected. - Coming from
22.0.0-rc.0, runng update @angular/fire@next.ng addsaved the release candidate as an exact version, so it does not move on its own.- The v22 migration runs once more and reports "No changes made" when your
firebaseentry is already inside the supported range.
- Coming from a 22 canary build. On
22.0.0-canary.*, runng update @angular/fire@next. On22.0.1-canary.*, runng update @angular/fire@canary. - Screen tracking (
ScreenTrackingService) reads the routed component's selector through Angular'sreflectComponentType, becauseComponentFactoryResolveris gone from Angular 22. Nothing changes for your app. - Server rendering in one call.
initializeBrowserOrServerAppfrom@angular/fire/appreplaces theprovideFirebaseAppcallback the Authentication guide used to ask server-rendered apps to write. It builds the ordinary app in the browser and aFirebaseServerAppfor the visitor's tokens on the server, releases it, and renders signed out instead of failing on a token Firebase cannot parse. See Server-side Rendering. Existing callbacks keep working.