Skip to content

docs: refresh quickstart and README for current ng add and deploy paths - #3736

Open
armando-navarro wants to merge 1 commit into
angular:mainfrom
armando-navarro:docs-quickstart-refresh
Open

docs: refresh quickstart and README for current ng add and deploy paths#3736
armando-navarro wants to merge 1 commit into
angular:mainfrom
armando-navarro:docs-quickstart-refresh

Conversation

@armando-navarro

Copy link
Copy Markdown
Collaborator

Checklist

Description

Refreshes the Quickstart (docs/install-and-setup.md) and the README so they match how a current Angular app is created and how ng add @angular/fire behaves today.

  • Rewrite step 2 to what ng add actually does (writes provideFirebaseApp(...) into the app configuration with the config inlined, no environment files).
  • Fix the scaffold file and class names in steps 3 and 4 (app.ts and class App, templateUrl/styleUrl), and type the Firestore binding with an Item interface.
  • Replace the broken ng deploy step with guidance for both paths: Firebase Hosting for client-rendered apps, and Firebase App Hosting for server-rendered apps.
  • Add a "Before you begin" section covering the @next requirement on the newest Angular major, the Firebase CLI, and the harmless setup prompts.
  • README: fix the "Example use" snippet, drop the removed single-command deploy bullet, remove the outdated "developer preview" note, alphabetize the product-integrations table, and make the Stackblitz note template-agnostic.

Documentation only, no source or API changes.

Fixes #3735
Refs #3667

The quickstart described the pre-v7 ng add (environment files and
AngularFireModule) and told users to run ng deploy, which no longer
works on a fresh project. Correct step 2 to what ng add writes today
(provideFirebaseApp in the app config, no environment files), fix the
scaffold file and class names to app.ts and class App, type the
Firestore binding with an Item interface, and split step 6 into the
client-rendered path (Firebase Hosting) and the server-rendered path
(App Hosting).

Add a Before you begin section covering the @next requirement on the
newest Angular major, the Firebase CLI, and the harmless CLI prompts.

README: drop the obsolete single-command deploy bullet, remove the
developer-preview disclaimer, fix the appConfig example (brace and
missing imports), alphabetize the product-integrations table, and make
the Stackblitz note template-agnostic.
@armando-navarro armando-navarro added comp: docs Documentation. type: chore Maintenance with no user-facing behavior change. labels Aug 4, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

comp: docs Documentation. type: chore Maintenance with no user-facing behavior change.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: the quickstart and README are out of date for the current setup and deploy flow

1 participant