$ dart pub global activate flutist

my_app/
  app/                         # 앱 셸 (simple 타입)
    lib/app.dart
    pubspec.yaml
  features/
    auth/
      auth_domain/             # UseCase, Entity, Repository interface
        lib/auth_domain.dart
        pubspec.yaml
      auth_data/               # Repository 구현체, API 클라이언트
        lib/auth_data.dart
        pubspec.yaml
      auth_presentation/       # UI, BLoC
        lib/auth_presentation.dart
        pubspec.yaml
  flutist/
    flutist_gen.dart           # ⚠ 자동 생성 — 수정 금지
    templates/
  lib/main.dart
  package.dart                 # 의존성 버전 레지스트리
  project.dart                 # 모듈 선언
  pubspec.yaml                 # 루트 workspace

// 1. package.dart — 버전을 한 번만 선언
Dependency(name: 'dio', version: '^5.3.0'),
Dependency(name: 'flutter_bloc', version: '^8.1.6'),

// 2. flutist_gen.dart — flutist generate가 자동 생성
Dependency get dio         => dependencies.firstWhere((d) => d.name == 'dio');
Dependency get flutterBloc => dependencies.firstWhere((d) => d.name == 'flutter_bloc');
Module     get authDomain   => modules.firstWhere((m) => m.name == 'auth_domain');

// 3. project.dart — 타입 안전하게 참조 (IDE 자동완성 ✅)
Module(
  name: 'auth_data',
  dependencies: [package.dependencies.dio, package.dependencies.flutterBloc],
  modules: [package.modules.authDomain],
),

$ flutist generate
✓ pubspec.yaml 동기화: app, auth_domain, auth_data, auth_presentation,
                      product_interface, product_implementation ... (총 24개)
✓ 모든 아키텍처 규칙 통과
✓ 완료 (0.8s)

$ flutist generate
✗ [B4] auth_domain → auth_data: 역방향 의존성 감지 — domain은 data를 알 수 없음
   → auth_domain에서 Dio import를 제거하고 Repository interface만 선언하세요
✗ generate 중단 (strictMode: true)

# micro 타입으로 todos 피처 생성 — 5개 패키지 + 구조 전체 자동화
$ flutist create --name todos --path features --options micro
✓ features/todos/todos_interface      생성
✓ features/todos/todos_implementation 생성
✓ features/todos/todos_testing        생성
✓ features/todos/todos_tests          생성
✓ features/todos/todos_example        생성

# BLoC scaffold로 모든 파일 생성
$ flutist scaffold --template bloc --name todos_overview --path features/todos/todos_implementation
✓ todos_overview_bloc.dart  생성
✓ todos_overview_event.dart 생성
✓ todos_overview_state.dart 생성

import 'package:flutist/flutist.dart';

final package = Package(
  name: 'my_app',

  dependencies: [
    Dependency(name: 'http',         version: '^1.1.0'),
    Dependency(name: 'bloc',         version: '^8.1.0'),
    Dependency(name: 'flutter_bloc',  version: '^8.1.0'),
    Dependency(name: 'test',         version: '^1.24.0'),
    Dependency(name: 'mockito',      version: '^5.4.4'),
  ],

  modules: [
    Module(name: 'app'),
    Module(name: 'auth_domain'),
    Module(name: 'auth_data'),
    Module(name: 'auth_presentation'),
  ],
);

import 'package:flutist/flutist.dart';
import 'flutist/flutist_gen.dart';
import 'package.dart';

final project = Project(
  name: 'my_app',

  options: const ProjectOptions(
    strictMode: true,            // 위반 시 generate 중단
    compositionRoots: ['app'], // _implementation 직접 참조 허용 모듈
  ),

  modules: [
    Module(
      name: 'auth_domain',
      dependencies: [],
      devDependencies: [package.dependencies.test],
      modules: [],
    ),
    Module(
      name: 'auth_data',
      dependencies: [package.dependencies.http],
      devDependencies: [package.dependencies.test, package.dependencies.mockito],
      modules: [package.modules.authDomain],
    ),
    Module(
      name: 'auth_presentation',
      dependencies: [package.dependencies.bloc, package.dependencies.flutterBloc],
      devDependencies: [package.dependencies.test],
      modules: [package.modules.authDomain],
    ),
    Module(
      name: 'app',
      modules: [package.modules.authPresentation],
    ),
  ],
);

// ⚠️ Auto-generated by flutist. Do not modify.

extension PackageDependenciesX on List<Dependency> {
  Dependency get http        => firstWhere((d) => d.name == 'http');
  Dependency get bloc        => firstWhere((d) => d.name == 'bloc');
  Dependency get flutterBloc => firstWhere((d) => d.name == 'flutter_bloc');
  Dependency get test        => firstWhere((d) => d.name == 'test');
}

extension PackageModulesX on List<Module> {
  Module get app              => firstWhere((m) => m.name == 'app');
  Module get authDomain       => firstWhere((m) => m.name == 'auth_domain');
  Module get authData         => firstWhere((m) => m.name == 'auth_data');
  Module get authPresentation => firstWhere((m) => m.name == 'auth_presentation');
}

$ flutist create --name auth --path features --options clean

Module(name: 'auth_domain', modules: []),
Module(
  name: 'auth_data',
  modules: [package.modules.authDomain],   # data → domain
),
Module(
  name: 'auth_presentation',
  modules: [package.modules.authDomain],   # presentation → domain (data 아님)
),

$ flutist create --name network --path packages --options micro

$ flutist create --name storage --path packages --options lite

$ flutist create --name utils --path packages

packages/utils/
  lib/utils.dart
  pubspec.yaml
  analysis_options.yaml
  README.md

$ mkdir my_app && cd my_app
$ flutist init

Do you want to create a new Flutter project? (y/n): y
▶ flutter create . --project-name my_app
▶ project.dart / package.dart 생성
▶ app/ 모듈 생성 (simple 타입)
▶ flutist_gen.dart 생성

$ cd existing_project && flutist init

1) New project  2) Migration?: 2
▶ project.dart / package.dart 생성 (기존 pubspec.yaml 보존)
▶ flutist_gen.dart 생성

$ flutist create --name auth --path features --options clean
$ flutist create --name network --path packages --options micro
$ flutist create --name storage --path packages --options lite
$ flutist create --name utils --path packages

$ flutist check

✓ [B1] Implementation references: OK
✓ [B2] Testing layer references: OK
✓ [B3] Example layer references: OK
✗ [B4] auth_domain → auth_data: domain must not depend on data
✓ [B5] Circular dependencies: OK

$ flutist pub add http
$ flutist pub add bloc flutter_bloc freezed

$ flutist scaffold list
$ flutist scaffold bloc_feature --name login
$ flutist scaffold bloc_feature --name login --path lib/features

$ flutist test
$ flutist test --module auth_domain

$ flutist graph --open
$ flutist graph --format dot --output graph.dot
$ flutist graph --format ascii

options: const ProjectOptions(
  compositionRoots: ['app', 'dev_app'],  // 여러 composition root 지정 가능
),

options: const ProjectOptions(
  strictMode: false,  // 마이그레이션 기간 동안 임시 비활성화
  compositionRoots: ['app'],
),

description: "BLoC Feature Template"
attributes:
  - name: name
    required: true
  - name: path
    required: false
    default: "lib/features"
items:
  - type: file
    path: "{{path}}/{{name | snake_case}}/{{name | snake_case}}_bloc.dart"
    templatePath: "bloc.dart.template"
  - type: string
    path: "{{path}}/{{name | snake_case}}/README.md"
    contents: |
      # {{name | pascal_case}}

import 'package:bloc/bloc.dart';

part '{{name | snake_case}}_event.dart';
part '{{name | snake_case}}_state.dart';

class {{name | pascal_case}}Bloc
    extends Bloc<{{name | pascal_case}}Event, {{name | pascal_case}}State> {
  {{name | pascal_case}}Bloc() : super(const {{name | pascal_case}}Initial()) {
    on<{{name | pascal_case}}Started>(_onStarted);
  }
  Future<void> _onStarted({{name | pascal_case}}Started event, Emitter<{{name | pascal_case}}State> emit) async {}
}

part of '{{name | snake_case}}_bloc.dart';

sealed class {{name | pascal_case}}Event { const {{name | pascal_case}}Event(); }

final class {{name | pascal_case}}Started extends {{name | pascal_case}}Event {
  const {{name | pascal_case}}Started();
}

part of '{{name | snake_case}}_bloc.dart';

sealed class {{name | pascal_case}}State { const {{name | pascal_case}}State(); }

final class {{name | pascal_case}}Initial extends {{name | pascal_case}}State { const {{name | pascal_case}}Initial(); }
final class {{name | pascal_case}}Loading extends {{name | pascal_case}}State { const {{name | pascal_case}}Loading(); }
final class {{name | pascal_case}}Loaded<T> extends {{name | pascal_case}}State {
  final T data; const {{name | pascal_case}}Loaded(this.data);
}
final class {{name | pascal_case}}Error extends {{name | pascal_case}}State {
  final String message; const {{name | pascal_case}}Error(this.message);
}

$ flutist scaffold bloc_feature --name login --path lib/features

✓ lib/features/login/login_bloc.dart
✓ lib/features/login/login_event.dart
✓ lib/features/login/login_state.dart

import 'package:riverpod_annotation/riverpod_annotation.dart';
import '{{name | snake_case}}_state.dart';

part '{{name | snake_case}}_notifier.g.dart';

@riverpod
class {{name | pascal_case}}Notifier extends _${{name | pascal_case}}Notifier {
  @override
  {{name | pascal_case}}State build() => const {{name | pascal_case}}State.initial();

  Future<void> load() async {
    state = const {{name | pascal_case}}State.loading();
    try {
      state = const {{name | pascal_case}}State.loaded(null);
    } catch (e) {
      state = {{name | pascal_case}}State.error(e.toString());
    }
  }
}

import 'package:freezed_annotation/freezed_annotation.dart';

part '{{name | snake_case}}_state.freezed.dart';

@freezed
class {{name | pascal_case}}State with _${{name | pascal_case}}State {
  const factory {{name | pascal_case}}State.initial()          = _Initial;
  const factory {{name | pascal_case}}State.loading()          = _Loading;
  const factory {{name | pascal_case}}State.loaded(dynamic data) = _Loaded;
  const factory {{name | pascal_case}}State.error(String msg)   = _Error;
}