From 9e28433204f3ca758cc9462d79e842beba337e36 Mon Sep 17 00:00:00 2001 From: Armando Navarro Date: Tue, 29 Sep 2026 15:06:45 -0700 Subject: [PATCH] docs: drop the --save-exact step for the release candidate The 25 canary releases that outranked 21.0.0-rc.1 are deprecated on npm, so `ng update` and `ng add` with `@angular/fire@next` now install the release candidate without it. Fixes #3777 --- docs/install-and-setup.md | 6 ------ docs/version-21-upgrade.md | 6 ------ 2 files changed, 12 deletions(-) diff --git a/docs/install-and-setup.md b/docs/install-and-setup.md index d16a56918..5dc079816 100644 --- a/docs/install-and-setup.md +++ b/docs/install-and-setup.md @@ -48,12 +48,6 @@ This installs AngularFire and configures your project. `ng add` will: 1. Prompt you to select the features to enable and the Firebase project to use, signing you in to Firebase if needed. 2. Add `provideFirebaseApp(...)`, along with a provider for each feature you select, to your app configuration (for example `app.config.ts`), with your Firebase configuration inlined. No environment files are created. -`ng add` writes the version it installed into your `package.json`, and today that is a canary release such as `21.0.0-rc.1-canary.95b3de1` rather than the release candidate. To replace it with the release candidate, `21.0.0-rc.1`, run: - -```bash -npm install --save-exact @angular/fire@next -``` - ### 3. Inject `Firestore` Open `/src/app/app.ts` and make the following changes: diff --git a/docs/version-21-upgrade.md b/docs/version-21-upgrade.md index e8d07bf8c..1f3cbbe09 100644 --- a/docs/version-21-upgrade.md +++ b/docs/version-21-upgrade.md @@ -10,12 +10,6 @@ The release candidate is published under the `next` tag. From an app on Angular ng update @angular/core@21 @angular/cli@21 @angular/fire@next ``` -`ng update` writes the range `^21.0.0-rc.1` into your `package.json`. That range also matches canary releases, and npm currently installs one of them, such as `21.0.0-rc.1-canary.95b3de1`, instead of the release candidate. To install the release candidate itself, and stop npm from picking a canary release on a later install, change the entry to the exact version `21.0.0-rc.1` by running: - -```bash -npm install --save-exact @angular/fire@next -``` - The AngularFire update runs a migration that: - **Aligns your `firebase` dependency to `^12.18.0`.** AngularFire 21 requires Firebase JS SDK 12, at 12.18 or later. If your app requested an older `firebase`, whether that is 11 or an earlier 12, npm would install both that copy and the one AngularFire needs side by side, and the two copies reject each other's objects at runtime. The migration updates the dependency and reinstalls so you end up with a single copy. Verify with `npm ls firebase`.