optikit-marketplace

🚀 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