flutter-new

Create New Flutter Project

This command creates a new Flutter project with optional templates and pre-configured state management, architecture patterns, and development tools.

Usage

/flutter-new <project-name> [template] [options]

Templates

• basic - Minimal Flutter app (default)
• material3 - Material Design 3 with theming
• clean-arch - Clean architecture structure
• full-stack - Flutter app + ServerPod backend

Options

• --state-management=<provider|bloc|riverpod> - Pre-configure state management
• --platforms=<android,ios,web,windows,macos,linux> - Enable specific platforms
• --org=<com.example> - Organization identifier

Examples

# Basic Material 3 app
/flutter-new my_app material3

# Clean architecture with BLoC
/flutter-new my_app clean-arch --state-management=bloc

# Full-stack app with ServerPod
/flutter-new my_backend full-stack

# Web-only app with Riverpod
/flutter-new my_web_app basic --platforms=web --state-management=riverpod

Implementation

When this command runs:

1. Parse Arguments

   • Extract project name (required)
   • Extract template (default: basic)
   • Parse options (state management, platforms, org)
   • Validate project name (lowercase, underscores only)

2. Ask for Clarifications (if needed)

   • If no template specified, ask which template
   • If no state management specified for non-basic template, ask preference
   • If no platforms specified, use Flutter defaults

3. Create Base Project

   flutter create \
     --project-name=<project_name> \
     --org=<org_id> \
     --platforms=<platforms> \
     <project_name>
   

4. Apply Template Based on selected template:

   material3 template:

   • Update lib/main.dart with Material 3 theming
   • Add ThemeData with useMaterial3: true
   • Configure ColorScheme.fromSeed()
   • Add dark theme support
   • Create lib/theme/ directory with theme configuration

   clean-arch template:

   • Create directory structure:

     lib/
     ├── core/
     │   ├── error/
     │   ├── network/
     │   └── utils/
     ├── features/
     │   └── example/
     │       ├── data/
     │       │   ├── datasources/
     │       │   ├── models/
     │       │   └── repositories/
     │       ├── domain/
     │       │   ├── entities/
     │       │   ├── repositories/
     │       │   └── usecases/
     │       └── presentation/
     │           ├── pages/
     │           └── widgets/
     └── main.dart
     

   • Add dependency injection setup (get_it)
   • Create example feature with complete layers