Flutter + Firebase Starter
A production-ready Flutter boilerplate for cross-platform mobile apps. Firebase auth, Firestore database, push notifications, deep linking, and a modular feature architecture — iOS and Android from one codebase.
A production-ready Flutter boilerplate for cross-platform mobile apps. Firebase auth, Firestore database, push notifications, deep linking, and a modular feature architecture — iOS and Android from one codebase.
Open for personal & commercial use
What is Flutter + Firebase Starter?
Building a cross-platform mobile app with Flutter and Firebase is one of the most efficient paths to a live iOS + Android product. But the setup — Firebase project configuration, native SDK integration, platform-specific permission handling, Firestore security rules, deep link routing, and push notification plumbing — takes an experienced developer 1–2 weeks before they can write a single feature. This Flutter + Firebase Starter collapses that setup into an afternoon. The architecture follows a feature-first folder structure with BLoC state management — the pattern used in production Flutter apps with millions of users. Firebase is configured for both platforms, security rules are included, and push notifications are wired end-to-end for iOS (APNs) and Android (FCM).
Everything in the package.
Firebase Authentication
Email/password, Google Sign-In, and Apple Sign-In — configured for both iOS and Android with proper native SDK setup and entitlements.
Firestore Database Layer
Repository pattern abstraction over Firestore. Generic CRUD operations, real-time stream subscriptions, and pagination — all typed with Dart generics.
Push Notifications (FCM + APNs)
End-to-end push notification setup — Firebase Cloud Messaging on Android, APNs on iOS, foreground and background handlers, and a notification centre screen.
Deep Linking
Universal links (iOS) and App Links (Android) configured and handled in the router. Share links that open specific screens — with fallback to web if app is not installed.
BLoC State Management
Feature-level BLoC classes with events, states, and cubits. Includes example BLoCs for auth, user profile, and a data listing screen.
Onboarding Flow
Multi-step onboarding screens with progress indicator, shown only on first app launch using SharedPreferences persistence.
App Settings Screen
Profile editing, notification preferences, theme switching, and account deletion — all wired to Firebase and local storage.
Firebase Security Rules
Firestore security rules that enforce user ownership — users can only read and write their own documents. Copy to your Firebase Console and you're protected.
Built for production, not demos.
Feature-First Architecture
Folder structure organised by feature, not by type — auth/, profile/, notifications/, etc. Each feature is self-contained with its own BLoC, repository, and UI layers.
Flavour Configuration
Development, staging, and production flavours configured out of the box. Different Firebase projects per environment — no risk of dev data polluting production.
Responsive UI
All screens adapt to phone, tablet, and iPad sizes using adaptive layout utilities. No hardcoded pixel values — everything scales with screen size.
Error Handling
Centralised error handling with user-friendly messages. Firebase errors are mapped to readable strings. Crash reporting via Firebase Crashlytics is configured.
Offline Support
Firestore offline persistence is enabled — the app works with cached data when offline and syncs automatically when connectivity is restored.
CI/CD Ready
GitHub Actions workflow for running tests, building release APK and IPA, and deploying to Firebase App Distribution. Ready to enable, no configuration required.
Who is this for?
Developers, indie hackers, and product teams who want to skip the boilerplate and ship faster.
Mobile Founders Launching Cross-Platform
One codebase, two stores. This starter gets you to a working iOS + Android app in days instead of weeks — with the infrastructure that scales past launch.
Web Developers Moving to Mobile
Flutter's reactive UI model is intuitive for developers who know React or Vue. This starter handles the mobile-specific plumbing so you can focus on the UI you already know how to build.
Agencies Delivering Mobile Projects
Reusable across client projects. Swap the Firebase project, customise the theme and screens, and deliver a production-ready mobile app faster than building from scratch.
SaaS Products Adding a Mobile App
Your existing SaaS users expect a mobile app. This starter provides the mobile foundation — connect it to your existing backend alongside Firebase for auth and notifications.
Technologies used.
Framework
Firebase
Platform
Architecture
Common questions.
Do I need experience with BLoC to use this?
Some Flutter experience helps. BLoC is well-documented and the starter includes example BLoCs you can read and copy. The README links to the official BLoC documentation for each pattern used.
Can I replace BLoC with Riverpod or Provider?
Technically yes, but it requires rewriting all the state management layers. BLoC is deeply integrated by design — it's the pattern used in large-scale Flutter apps and worth learning.
Does this include an App Store submission guide?
The README covers the technical submission steps — signing, build settings, and Info.plist requirements. Full App Store review guideline compliance is your responsibility.
Is this compatible with Flutter 3.x?
Yes — built and tested on Flutter 3.16+ with Dart 3 null safety throughout. The pubspec.yaml pins major dependency versions and a flutter pub upgrade guide is included.
Can I add in-app purchases?
Not out of the box, but the architecture supports it cleanly. The README includes guidance on adding the in_app_purchase package with the same BLoC pattern used throughout the starter.
Need something custom-built?
Need a Flutter app built custom — with a specific backend, unique UI design, payment integration, hardware features, or complex offline sync? Our mobile team has shipped 40+ Flutter apps across healthcare, fintech, and consumer. We can extend this starter or build your app from scratch.
Ready to ship faster?
Buy Flutter + Firebase Starter today and go from zero to a live iOS + Android app in days — not weeks.
Setup and implementation
Review prerequisites, installation steps, and configuration before integrating this product.
Read the setup documentation