Auth Guide for Indie Devs

Interactive guide to mobile authentication with Apple Sign-In, Google Sign-In, and Anonymous mode on Flutter + Firebase.

Live site: https://fithappensml.github.io/flutter-firebase-auth-guide/

Contents

The guide is organized into six topics, each with a diagram and detail sections:

• Overview — the auth flow and the constraints that shape it
• Providers — Apple, Google, Anonymous setup with Flutter code samples
• Firebase Auth — what Firebase handles, token model, session persistence
• Privacy & Legal — App Store and Play Store requirements, GDPR essentials
• Pitfalls & Checklist — common bugs with diagnosis tree, downloadable pre-ship checklist
• Cost — pricing breakdown for years 1, 2, 3

Diagrams are clickable: each node links to the relevant topic.

Running locally

git clone https://github.com/FitHappensML/flutter-firebase-auth-guide.git
cd flutter-firebase-auth-guide
python3 -m http.server 8000

Open http://localhost:8000/. No build step.

Alternative servers if you don't have Python: npx serve ., or VS Code with the Live Server extension.

After editing files, hard-refresh the browser (Ctrl+Shift+R on Windows/Linux, Cmd+Shift+R on macOS).

Editing

• Topic content: topics/*.md (Markdown with frontmatter and inline Mermaid blocks)
• Topic order and labels: topics/_index.json
• Layout, sidebar, viewer: index.html
• Theme colors and fonts: tokens.css

Structure

.
├── index.html               page shell with TOC sidebar and viewer
├── tokens.css               design tokens
├── pre-ship-checklist.md    downloadable Markdown, linked from Pitfalls topic
├── .nojekyll                disables GitHub Pages Jekyll processing — do not delete
└── topics/
    ├── _index.json          topics manifest
    ├── 00-overview.md
    ├── 01-providers.md
    ├── 02-firebase.md
    ├── 03-privacy-legal.md
    ├── 04-pitfalls.md
    └── 05-cost.md

External dependencies are CDN-hosted: Google Fonts, marked, mermaid.

Contributing

Issues and pull requests welcome. If you've hit a pitfall not listed in the guide, open an issue with the symptom and the fix.

Author

FitHappensML on X / Twitter, @FitHappensML on Telegram.