flutter_clean_starter 0.1.1

Skip the boilerplate. Start building Flutter apps the right way.

Flutter Clean Starter

Skip the boilerplate. Start building Flutter apps the right way.

A command-line tool that generates production-ready Flutter projects with Clean Architecture, BLoC/Cubit/Riverpod, Dio, and GetIt — all wired up from a single interactive command.

Features

• Clean Architecture folder structure out of the box
• Choose your state management — BLoC, Cubit, or Riverpod
• Select only the feature modules you need
• Dio client with interceptor and PrettyDioLogger pre-configured
• GetIt + Injectable dependency injection ready for build_runner
• Optional Flutter Flavors setup (dev / staging / prod)
• Runs flutter pub get automatically

Installation

dart pub global activate flutter_clean_starter

Make sure your PATH includes the pub cache bin directory:

# Add to your .zshrc or .bashrc
export PATH="$PATH":"$HOME/.pub-cache/bin"

Usage

flutter_clean_starter create

The CLI will guide you through:

1. Project name and bundle ID
2. State management (BLoC / Cubit / Riverpod)
3. Feature modules (auth, home, profile, settings, onboarding)
4. Flutter Flavors setup

Generated structure

lib/ ├── core/ │ ├── constants/ │ ├── error/ │ ├── network/ # Dio client + interceptor │ ├── router/ # GoRouter setup │ ├── theme/ │ └── usecase/ # UseCase base class ├── di/ # GetIt + Injectable └── features/ └── auth/ # per selected feature ├── data/ │ ├── datasources/ │ ├── models/ │ └── repositories/ ├── domain/ │ ├── entities/ │ ├── repositories/ │ └── usecases/ └── presentation/ ├── bloc/ ├── pages/ └── widgets/

After generation

cd your_project
flutter pub run build_runner build --delete-conflicting-outputs
code .

Requirements

• Dart SDK >= 3.0.0
• Flutter SDK installed and on PATH

License

MIT