Skip to content

Expand Firebase page with setup, Auth, and database guides - #13980

Merged
jesskuras merged 9 commits into
flutter:mainfrom
jesskuras:expand-firebase-page
Oct 23, 2026
Merged

jesskuras merged 9 commits into
flutter:mainfrom
jesskuras:expand-firebase-page

Conversation

@jesskuras

Copy link
Copy Markdown
Contributor

Description of what this PR is changing or adding, and why:

Expands /data-and-backend/firebase with on-domain setup instructions, code examples, and architectural guidance for building Flutter apps with Firebase:

  • Adds a summary table of common Firebase services for Flutter (cloud_firestore, firebase_data_connect, firebase_auth, firebase_storage, firebase_ai, cloud_functions / firebase_functions, and firebase_crashlytics).
  • Adds a Connect a Flutter app to Firebase section walking through flutterfire_cli, flutterfire configure, and Firebase.initializeApp().
  • Adds an Authenticate users with Firebase Authentication section with a StreamBuilder auth-state example and email/password sign-in.
  • Adds a Store and sync NoSQL data with Cloud Firestore section showing how to write documents and stream realtime query snapshots.
  • Adds a Query relational SQL data with Firebase SQL Connect section explaining generated type-safe Dart SDKs for PostgreSQL.
  • Adds a Share Dart code with a serverless Firebase backend section highlighting Cloud Functions for Firebase in Dart and the shared-package pattern.
  • Updates the Firebase for Flutter description in llms.txt.

Issues fixed by this PR (if any):

PRs or commits this PR depends on (if any):

Presubmit checklist

  • If you are unwilling, or unable, to sign the CLA, even for a tiny, one-word PR, please file an issue instead of a PR.
  • If this PR is not meant to land until a future stable release, mark it as draft with an explanation.
  • This PR follows the Google Developer Documentation Style Guidelines—for example, it doesn't use i.e. or e.g., and it avoids I and we (first-person pronouns).
  • This PR uses semantic line breaks of 80 characters or fewer.

@flutter-website-bot

flutter-website-bot commented Oct 13, 2026 •

Copy link
Copy Markdown
Collaborator

jesskuras and others added 5 commits October 13, 2026 21:55
- Remove Go from the Cloud Functions for Firebase language list; Firebase
  ships SDKs for Node.js (JavaScript/TypeScript), Python, and Dart.
- Note that Dart support for Cloud Functions is experimental and requires
  enabling the dartfunctions experiment in the Firebase CLI.
- Generalize the platform list in the intro so it covers Windows (beta).
- Clarify that SignInScreen in the auth example is a placeholder, since
  FirebaseUI exports a widget with the same name.
- Replace 'vs.' per the style guide.
The detailed SQL Connect pitch already lives on the Choose a database
page; keep this page to a short summary plus links.
@jesskuras
jesskuras marked this pull request as ready for review October 22, 2026 22:14
@jesskuras
jesskuras requested review from a team and sfshaza2 as code owners October 22, 2026 22:14

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request updates the Firebase documentation and the LLM resource list to provide a comprehensive guide on connecting Flutter apps to Firebase, covering authentication, Firestore, SQL Connect, and serverless Dart functions. The review feedback correctly identifies several naming inaccuracies that need to be addressed, specifically updating 'Firebase SQL Connect' to 'Firebase Data Connect' and 'Firebase AI Logic' to 'Vertex AI in Firebase' (along with its package firebase_vertexai). Additionally, the Firestore code example should be refactored from a StatelessWidget to a StatefulWidget to avoid the performance anti-pattern of recreating the stream subscription inside the build method.

@abdallahshaban557

Copy link
Copy Markdown
Contributor

@jesskuras - could you check the Gemini comments, I can review this afterwards!

Create the query stream once in State rather than on every rebuild,
so StreamBuilder doesn't resubscribe each time the widget rebuilds.
@jesskuras

Copy link
Copy Markdown
Contributor Author

@jesskuras - could you check the Gemini comments, I can review this afterwards!

Done! There was only one legitimate one, but I made that change real quick. :)

@abdallahshaban557

Copy link
Copy Markdown
Contributor

@jesskuras - left my feedback! The only blocking piece is the offline first part on firestore. Otherwise, LGTM!

…sentence

- Describe Cloud Firestore as offering offline caching and persistence
  rather than being offline-first.
- Drop 'from your schema and queries' from the SQL Connect summary.
Replace 'offline-first' with 'offline caching' to match the Firebase
page and Cloud Firestore's actual capabilities.
@jesskuras

Copy link
Copy Markdown
Contributor Author

@jesskuras - left my feedback! The only blocking piece is the offline first part on firestore. Otherwise, LGTM!

Amazing, thanks a bunch!

@jesskuras
jesskuras merged commit 7b83f1f into flutter:main Oct 23, 2026
14 checks passed
@jesskuras
jesskuras deleted the expand-firebase-page branch October 23, 2026 16:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants