flutter-flavor-init

Flutter プロジェクトを Flavor（dev / stg / prod）付きで初期化する Claude Code プラグインです。 flutter create の実行から Android・iOS・Dart の Flavor 設定までを自動で行います。

対応プラットフォーム: Android / iOS のみ（Web・Windows・macOS・Linux に非対応）

機能

• flutter create によるプロジェクト生成
• Android の productFlavors 設定（build.gradle.kts）
• iOS の Build Configuration・Scheme 設定（project.pbxproj / xcscheme）
• Dart の環境切り替えコード生成（lib/env.dart）
• VS Code のデバッグ設定生成（.vscode/launch.json）

前提条件

• Claude Code がインストール・認証済みであること
• Flutter SDK がインストール済みであること

インストール

GitHub から直接インストールする（推奨）

クローン不要で、Claude Code 内から直接インストールできます。

# 1. マーケットプレイスとして追加
/plugin marketplace add abe-tk/flutter-flavor-init-plugin

# 2. プラグインをインストール
/plugin install flutter-flavor-init@abe-tk-flutter-flavor-init-plugin

ローカルで使用する場合

リポジトリをクローンし、--plugin-dir フラグで読み込みます。

git clone https://github.com/abe-tk/flutter-flavor-init-plugin.git
claude --plugin-dir ./flutter-flavor-init-plugin

使い方

Claude Code 起動後、スキルを呼び出します。

/flutter-flavor-init:flutter-flavors-init my-app --org com.example --flavors dev,stg,prod

引数

引数	必須	説明	例
プロジェクト名	はい	英語ケバブケース	my-app
--org	いいえ	組織ドメイン（未指定時は対話で確認）	com.example
--flavors	いいえ	環境リスト（未指定時は対話で確認）	dev,prod / dev,stg,prod

実行例

# 最小限の指定（org と flavors は対話で確認される）
/flutter-flavor-init:flutter-flavors-init my-app

# すべて指定
/flutter-flavor-init:flutter-flavors-init my-app --org com.example --flavors dev,prod

生成されるプロジェクト構造

my-app/
├── android/
│   └── app/
│       ├── build.gradle.kts          # productFlavors 追加済み
│       └── src/main/AndroidManifest.xml
├── ios/
│   └── Runner.xcodeproj/
│       ├── project.pbxproj           # Build Configuration 追加済み
│       └── xcshareddata/xcschemes/
│           ├── dev.xcscheme
│           ├── stg.xcscheme           # flavors に stg を含む場合
│           └── prod.xcscheme
├── lib/
│   ├── main.dart
│   └── env.dart                      # Flavor 切り替えコード
└── .vscode/
    └── launch.json                   # Flavor 別デバッグ設定

補足

CocoaPods 導入時

ネイティブコードを含む Flutter プラグインを追加した際、ios/Podfile に全 Configuration を列挙する必要があります。

project 'Runner', {
  'Debug' => :debug,
  'Debug-dev' => :debug,
  'Debug-prod' => :debug,
  'Profile' => :release,
  'Profile-dev' => :release,
  'Profile-prod' => :release,
  'Release' => :release,
  'Release-dev' => :release,
  'Release-prod' => :release,
}

テンプレートの更新について

iOS のテンプレート（pbxproj-configurations-*.txt / scheme.xcscheme.template）は flutter create が生成する固定 UUID に依存しています。Flutter SDK のメジャーバージョンアップで UUID が変更された場合、テンプレートの更新が必要です。

ライセンス

MIT