🚀 OptiKit CLI
Build, version, and deploy Flutter apps in one CLI.
The command-line toolkit for Flutter & Opticore developers.
⚡ Install & Go
npm install -g optikit
You get two commands — optikit (full name) and ok (shorthand). Both work identically.
optikit init # 🔧 Setup OptiKit in your project
optikit bump patch # 📦 1.0.0 → 1.0.1
optikit apk # 🏗️ Build release APK
optikit tf -o # 🚀 TestFlight: bump iOS + build IPA + open
optikit gen module login -r # 🧩 Generate BLoC module with route
optikit aliases # 📋 See all shortcuts
💡 Prefer shorter commands? Use ok instead of optikit — every example above works with both.
🔥 Why OptiKit?
| Feature | Description |
|---|
| 🤖 Claude Code Plugin | AI understands your project and acts on it via MCP |
| ✅ Short aliases | Every command has a memorable shortcut |
| ✅ Combo flags | Clean, bump, build, and open in one command |
| ✅ Smart versioning | Dual iOS/Android build numbers handled automatically |
| ✅ Auto backups | Version files backed up before every change |
| ✅ Module scaffolding | Full BLoC pattern generated in one command |
| ✅ FVM support | Built-in Flutter Version Manager integration |
📖 Commands at a Glance
Every command has a short alias. Run optikit aliases to see the full list in your terminal.
🏗️ Build
| Command | Alias | What it does |
|---|
optikit flutter-build-apk | apk | Build release APK |
optikit flutter-build-bundle | aab | Build release AAB |
optikit flutter-build-ios | ios | Build iOS app |
optikit flutter-build-ipa | ipa | Build release IPA |
optikit testflight | tf | Bump iOS build + build IPA |
Combo flags — mix and match on any build command:
optikit apk --clean # 🧹 Clean → build
optikit ipa -b patch -o # 📦 Bump → build → open output
optikit ipa --clean -i -o # 🧹 Clean → bump iOS → build → open
optikit tf -o # 🚀 TestFlight → open output
🧹 Clean
| Command | Alias | What it does |
|---|
optikit clean | c | Clean Flutter project |
optikit clean-flutter | cf | Clean Flutter (explicit) |
optikit clean-ios | ci | Clean iOS / CocoaPods |
optikit clean -a # Clean all (Flutter + iOS)
optikit ci -cu # Clean iOS + cache + repo update
📦 Version
| Command | Alias | What it does |
|---|
optikit version | v | Show current version |
optikit bump patch | | Bug fix: 1.0.0 → 1.0.1 |
optikit bump minor | | Feature: 1.0.0 → 1.1.0 |
optikit bump major | | Breaking: 1.0.0 → 2.0.0 |
optikit bump-ios | bi | Bump iOS build only |
optikit bump-android | ba | Bump Android build only |
optikit bump-build | bb | Bump both build numbers |
📘 Deep dive: Version Management
🧩 Generate
optikit gen module login # Scaffold BLoC module
optikit gen module login -r # Scaffold + register route
optikit gen repo user # Generate repository
optikit route settings # Add route to app_router.dart
📱 Run & Open
dev-mahmoud-elshenawy