Flutter ArchKit #

The Ultimate Flutter Architecture Generator, Feature Scaffolder, Code Generator & Multi-Flavor CLI Toolkit

📖 Overview #

flutter_archkit is an enterprise-grade command-line interface (CLI) toolkit and code generator designed to eliminate architectural boilerplate and streamline Flutter app development.

Whether starting a greenfield project or scaling an existing production codebase, flutter_archkit automates:

• 🏗️ Project Scaffolding: Interactive wizard for Clean Architecture, MVVM, or MVC.
• ⚡ Feature Modules: One-command feature generator matching your project's architecture and state management.
• 🧠 @Archkit Code Generation: Automatically writes cascading UseCases, Repositories, DataSources, and API calls from annotated presentation handlers.
• 🛣️ Router Infrastructure: Scaffolds Navigator 1.0/2.0, Go Router (with Bottom Navigation Shells), Auto Route, or GetX Routing.
• 🌐 Network Layer: Scaffolds production Dio HTTP client with generic ApiResponse<T>, custom ApiException, interceptors, and typed contracts.
• 🎯 Multi-Flavor Environments: Configures Android Flavors, iOS Schemes & .xcconfig, Dart ServerConfig, VS Code launch.json, and Android Studio run configurations.

📚 Documentation Guides & Topics #

Explore dedicated, in-depth documentation guides for each architecture pattern and feature:

📑 Table of Contents #

• Documentation Guides & Topics
• Features & Architecture Matrix
• CLI Command Cheat Sheet
• Installation
• Usage Guide
  • 1. Creating a Project (archkit create)
  • 2. Scaffolding Feature Modules (archkit feature)
  • 3. Setting Up Route Systems (archkit route)
  • 4. Generating Network Layer (archkit network)
  • 5. @Archkit Code Generation (archkit generate)
  • 6. Multi-Flavor Configuration (archkit flavor)
• Directory Structures
• Example Application
• Contributing & Issues
• License

🧩 Features & Architecture Matrix #

⚡ CLI Command Cheat Sheet #

📦 Installation #

Global Activation (Recommended) #

Activate flutter_archkit globally to use the archkit CLI from anywhere in your terminal:

dart pub global activate flutter_archkit

Note: Ensure your global pub cache bin path is added to your system's PATH environment variable.

As a Project Dependency #

Add flutter_archkit to your Flutter project's pubspec.yaml under dev_dependencies to utilize the @Archkit annotation and flavor generators:

dev_dependencies:
  flutter_archkit: ^0.2.1

Then run:

flutter pub get

🚀 Usage Guide #

1. Creating a Project (archkit create) #

Scaffold a complete, production-ready Flutter application with interactive terminal prompts:

archkit create my_app

? Select Architecture:
  ❯ Clean Architecture (Data, Domain, Presentation, DI)
    MVVM Architecture (Models, Services, ViewModels, Views)
    MVC Architecture (Models, Controllers, Views)

? Select State Management:
  ❯ Bloc
    Cubit
    Riverpod
    Provider
    GetX

? Organization Identifier: com.example
? Target Platforms: android, ios, web

Non-Interactive CLI Mode

Automate CI/CD or scripted project generation using command-line flags:

archkit create my_app \
  --org com.example \
  --architecture Clean \
  --state-management Bloc \
  --platforms android,ios,web

2. Scaffolding Feature Modules (archkit feature) #

Generate modular, architecture-compliant feature packages in seconds. archkit automatically detects your project's architecture and state management from .metadata!

# Full command
archkit feature auth

# Or quick shortcut
archkit -f user_profile

Clean Architecture Feature Output (lib/features/auth/):

• domain/entities/auth_entity.dart
• domain/repositories/auth_repository.dart
• domain/usecases/auth_usecase.dart
• data/models/auth_model.dart
• data/data_sources/auth_remote_datasource.dart & _impl.dart
• data/repositories/auth_repository_impl.dart
• presentation/bloc/auth_bloc.dart, auth_event.dart, auth_state.dart
• presentation/page/auth_page.dart
• di/auth_di.dart

3. Setting Up Route Systems (archkit route) #

Set up a robust navigation infrastructure tailored to your preferred routing engine:

archkit route
# Or alias
archkit r

Supported Route Engines:

1. Navigator 1.0: Traditional named routes with RouteGenerator and MaterialPageRoute.
2. Navigator 2.0: Declarative routing with custom RouterDelegate and RouteInformationParser.
3. Go Router: URL-driven routing supporting deep links, route redirection, and optional StatefulShellRoute bottom navigation.
4. Auto Route: Type-safe code-generated navigation.
5. GetX Routing: Lightweight GetPage navigation.

4. Generating Network Layer (archkit network) #

Scaffold a battle-tested Dio network client architecture in lib/core/network/ and lib/core/util/:

archkit network
# Or alias
archkit n

5. Smart @Archkit Code Generation (archkit generate) #

Speed up development exponentially by designing your UI/Presentation layer first and generating all corresponding domain and data layer classes with a single command.

Step 1: Annotate your Presentation Method

Import package:flutter_archkit/flutter_archkit.dart and annotate event handlers or functions in your BLoC, Cubit, Riverpod Notifier, ViewModel, or Controller:

import 'package:flutter_archkit/flutter_archkit.dart';
import '../models/weather_model.dart';

class WeatherBloc extends Bloc<WeatherEvent, WeatherState> {
  WeatherBloc() : super(WeatherInitial()) {
    on<FetchWeatherEvent>(_onFetchWeather);
  }

  @Archkit(
    endpoint: '/weather',
    method: 'GET',
    returnType: WeatherModel,
  )
  Future<void> _onFetchWeather(
    FetchWeatherEvent event,
    Emitter<WeatherState> emit, {
    required String city,
    String? units,
  }) async {
    // Business logic...
  }
}

Step 2: Run Code Generator

# Run code generation on target feature
archkit generate --path lib/features/weather

# Or use shortcuts
archkit g -p lib/features/weather

# Preview changes without modifying files
archkit g -p lib/features/weather --dry-run

6. Multi-Flavor Configuration (archkit flavor) #

Easily configure enterprise-grade multi-environment setups (e.g. dev, staging, prod) for both Android and iOS in seconds.

# Initialize flavor.yaml template
archkit flavor --init

# Validate syntax
archkit flavor --validate

# Generate Android, iOS, Dart, and IDE flavor files
archkit flavor

📁 Directory Structures #

• 🏗️ Clean Architecture Details: doc/clean_architecture.md
• 🎨 MVVM Architecture Details: doc/mvvm_architecture.md
• 🏛️ MVC Architecture Details: doc/mvc_architecture.md

🌟 Example Application #

A full reference application demonstrating Clean Architecture, MVVM, MVC, Network Layer, Routing, and Flavor configurations is available in the example/ directory.

To run the example app:

cd example
flutter pub get
flutter run

🤝 Contributing & Issues #

Contributions, feature suggestions, and bug reports are welcome!

• 🐛 Report Issues: GitHub Issue Tracker
• 💡 Source Code: GitHub Repository

📄 License #

This project is licensed under the MIT License - see the LICENSE file for details.