fluframe 1.4.0

Generate production-ready Flutter apps from the fluFrame boilerplate — Riverpod 3, go_router, localization, theming, dio, and tests wired out of the box.

fluframe

Generate production-ready Flutter apps from the fluFrame boilerplate — Riverpod 3, go_router, localization, theming, dio, and tests wired out of the box.

▶ Try a generated app in your browser — the real thing, nothing installed.

Home	Sample REST feature	Theming & 3 locales

Straight out of fluframe create — no edits.

Install

Requires Flutter 3.44 or newer (Dart 3.12+) — generated apps declare sdk: ^3.12.1.

dart pub global activate fluframe

If fluframe is then not found, the pub cache's bin is not on your PATH. Add $HOME/.pub-cache/bin (macOS/Linux) or %LOCALAPPDATA%\Pub\Cache\bin (Windows) and reopen the terminal.

Usage

Runnable top to bottom, in this order:

fluframe doctor                      # check your environment first
fluframe create my_app --org com.mycompany --description "My shiny app"
cd my_app
flutter run --dart-define-from-file=env/dev.json

fluframe add feature billing --tab   # later: scaffold your next feature
fluframe upgrade                     # later: pull template updates in (dry-run)

Adding a feature

create runs once; add feature runs every time the app grows one:

fluframe add feature billing          # a full-screen route at /billing
fluframe add feature billing --tab    # ...or a bottom-navigation tab
fluframe add feature billing --dry-run

It writes the repository, controller, screen and two tests, registers the route in lib/app/router/app_router.dart, and adds the strings to all three ARBs — telling you which ones still carry the English text. Then run flutter gen-l10n.

Unlike upgrade, it is not dry-run by default: it only creates new files and makes bounded insertions at anchors the template ships. Apps generated before those anchors existed need fluframe upgrade first; the command says so rather than guessing.

Why fluframe

Every starter is a snapshot: you generate, and from that moment your app and the template diverge forever. fluframe is the only Flutter starter we know of that keeps the connection — fluframe upgrade reconstructs the template as it was at your generation version, three-way merges everything that changed since into your working tree, and reports genuine conflicts as conflicts instead of guessing. Your edits survive.

That is the reason to pick it, and it is not a reason to pick it over everything. If your team writes Bloc, or you need a package rather than an app, Very Good CLI is the better tool. docs/comparison.md lays both out honestly, including where fluframe loses.

What you get

• Riverpod 3 state management — manual Notifier/AsyncNotifier, no codegen for providers
• go_router 17 — StatefulShellRoute bottom tabs, nested routes
• freezed 3 + json_serializable models with a sample REST feature (dio)
• Typed error handling — DioException mapped to a sealed ApiException
• Localization — flutter gen-l10n with English, Japanese and Korean out of the box
• Material 3 theming — light/dark with a persisted ThemeMode
• Persisted settings — SharedPreferencesAsync behind a testable KeyValueStore
• Flavors — --dart-define-from-file with env/dev.json / env/prod.json
• Strict lints — very_good_analysis, zero warnings
• Tests — unit + widget tests using mocktail and Riverpod overrides

Options

Option	Default	Description
--org	com.example	Bundle/application identifier organization
--description	template default	Description for the new pubspec.yaml
--output-directory, -o	.	Where to create the project folder
--platforms	all six	Passed through to flutter create
--backend	none	Wire a real auth backend (supabase | firebase) into the generated app
--error-reporting	none	Wire crash reporting (sentry) into the error hooks
--analytics	none	Wire product analytics (amplitude) into the analytics seam
--no-pub	off	Skip flutter pub get / gen-l10n

How it works

fluframe create runs flutter create --empty first — so platform folders always match your installed Flutter version — then overlays the fluFrame application template (lib/, test/, l10n.yaml, env/, analysis_options.yaml, pubspec.yaml) and rewrites package-name tokens.

License

MIT