flutterstart 0.3.0

A review-first CLI for creating deterministic, production-ready Flutter projects.

FlutterStart

Create your Flutter project, your way.

FlutterStart Release 0.3 provides deterministic, review-first Flutter project creation with a configurable application foundation.

Installation

dart install flutterstart

For supported older Dart versions:

dart pub global activate flutterstart

Usage

flutterstart doctor
flutterstart create my_app

Supported Platforms

• macOS & Linux: Supported release targets, enforced by blocking CI gates.
• Windows: Provisional and non-blocking.

Features

• Deterministic project staging and content review before writes
• Explicit approval before destination materialization
• Recovery, staleness, and protected-file validation
• Flutter SDK and environment health checks
• Text and JSON command output
• Recommended, Customize, and Minimal setup modes
• Versioned schema_version: 3 YAML configuration
• Catalog-driven architecture, state, routing, backend, DI, data, and storage choices
• Application Foundation choices for initialization, environment, flavors, logging, errors, themes, localization, and project-structure conventions
• Deterministic in-package recipe resources with real format, analyze, and test gates

Application Foundation

Customize mode presents one optional Application Foundation section. Skipped capabilities are absent from the Blueprint; no none sentinel is stored. Project Structure is a stored convention in 0.3 and intentionally does not change generated files yet.

Non-interactive configuration uses the existing flat selection map:

schema_version: 3
project_name: demo_app
organization: com.example
destination: demo_app
target_platforms: [android, ios]
git: true
setup_mode: customize
single_selections:
  foundation.app_initialization: bootstrap
  foundation.logging: logger
  foundation.error_handling: global_boundary
  foundation.project_structure: feature_first

Version 1 and 2 configs upgrade on read. In version 3, the retired org.project_organization and org.localization keys are rejected with a structured LEGACY_RELOCATED_KEY error.

Planned features

• Visual web configurator
• Authentication starter
• CI/CD templates
• Structure-driven feature generation

Repository

https://github.com/MohamedAbd0/flutterstart