Flutter Starter Template

A production-ready Flutter starter template with clean architecture, theming, networking, and more.

Author: Pawan Gupta

Features

• Feature-first Clean Architecture
• Multi-environment support (development, staging, production)
• Riverpod + Flutter Hooks state management
• FQuery for data fetching and caching
• Dio HTTP client with interceptors
• GoRouter navigation with deep linking
• Light/Dark theme with dynamic colors
• Firebase Cloud Messaging
• Secure storage
• Reusable UI component library
• Form system with validation

Getting Started

Prerequisites

• Flutter SDK ^3.10.0
• Dart SDK ^3.10.0

Installation

flutter pub get

Running the App

# Development
flutter run

# Staging
flutter run --flavor staging --dart-define=FLAVOR=staging --dart-define=ENVIRONMENT=staging

# Production
flutter run --flavor production --dart-define=FLAVOR=production --dart-define=ENVIRONMENT=production

Project Structure

lib/
├── main.dart              # Entry point
├── app.dart               # Root widget
├── config/                # App configuration
├── routes/                # Navigation routes
├── screens/               # Full page screens
├── features/              # Feature modules (clean architecture)
├── core/                  # Shared components
├── services/              # Global services
├── hooks/                 # Custom hooks
├── theme/                 # Theming system
└── utils/                 # Utilities

License

MIT License - see LICENSE for details.