🚀 Flutter Pro Max CLI

The official command-line interface for deploying Flutter Pro Max technical intelligence to your favorite AI coding assistants.


---

📦 Installation

$3

Bootstrap any project in seconds. This command will guide you through selecting and installing the skill for your environment.

``bash
npx flutter-pro-max-cli
`

$3


For heavy users who want the flutter-pro-max command available everywhere:

`bash


Install globally

npm install -g flutter-pro-max-cli

Initialize in your project

flutter-pro-max init
`

---

🛠️ Usage

$3

Simply run the command and follow the prompts to detect and install the skill for your active AI assistants.

`bash
flutter-pro-max init
`

$3

For CI/CD or automated setups, you can specify the assistant type directly:

`bash


Install for a specific assistant

flutter-pro-max init --ai claude
flutter-pro-max init --ai cursor
flutter-pro-max init --ai antigravity

Install for all supported assistants

flutter-pro-max init --ai all
`

$3

`bash


List available versions from GitHub releases

flutter-pro-max versions

Update to the latest version

flutter-pro-max update
flutter-pro-max update --ai claude
`

---

🤖 Supported AI Assistants

This CLI bridges the gap between the Flutter Pro Max knowledge base and your development tools (16 platforms):

| Assistant | Type Flag | Install Type | Template | Limit |
|-----------|-----------|--------------|----------|-------|
| Claude Code | claude | Full | Full (~15KB) | No Limit |
| Codex CLI | codex | Full | Full (~15KB) | No Limit |
| Continue | continue | Full | Full (~15KB) | No Limit |
| JetBrains AI (Junie) | junie | Full | Full (~15KB) | No Limit |
| Gemini CLI | gemini | Full | Full (~15KB) | 1M+ Tokens |
| OpenCode | opencode | Full | Full (~15KB) | No Limit |
| CodeBuddy | codebuddy | Full | Full (~15KB) | No Limit |
| Trae | trae | Full | Full (~15KB) | No Limit |
| Antigravity (Google) | antigravity | Full | Compact (~5KB) | 12,000 chars |
| Cursor | cursor | Reference | Full (~13KB) | No Limit |
| Windsurf | windsurf | Reference | Full (~13KB) | No Limit |
| GitHub Copilot | copilot | Full | Full (~15KB) | No Limit |
| VS Code | vscode | Full | Full (~15KB) | No Limit |
| Kiro | kiro | Reference | Full (~13KB) | No Limit |
| RooCode | roocode | Reference | Full (~13KB) | No Limit |
| Qodo/Qoder | qoder | Reference | Full (~13KB) | No Limit |

Install Types:
- Full: Data và scripts nằm trong skill folder (standalone, ~500KB)
- Reference: Skill file trỏ đến .shared/ folder chung (tiết kiệm dung lượng khi dùng nhiều assistants)

Templates (theo platform limits - dựa trên Flutter AI Rules):
- Full (~15KB): Đầy đủ rules, code examples, Material 3 theming, accessibility
- Compact (~5KB): Core rules, essential patterns (Antigravity 12k limit)
- Mini (~2KB): Essential rules only (Copilot ~4k limit)

---

📊 What Gets Installed

$3


| Domain | File | Description |
|--------|------|-------------|
| Widgets | widget.csv | 65+ Flutter widgets |
| Packages | package.csv | 100+ packages với alternatives |
| Patterns | patterns.csv | 110+ design patterns |
| Architecture | architect.csv | Architecture layers |
| Performance | flutter-performance.csv | 35 optimization patterns |
| Accessibility | mobile-accessibility.csv | 35 accessibility patterns |
| UI Reasoning | ui-reasoning.csv | 35 app category decisions |
| Colors | colors.csv | 50+ color palettes |
| Typography | typography.csv | 40+ font pairings |
| Styles | styles.csv | 60+ UI styles |
| UX | ux-guidelines.csv | 50+ UX rules |
| Icons | icons.csv | 100+ icon recommendations |
| Landing | landing.csv | 30+ landing patterns |
| Products | products.csv | 40+ product recommendations |
| Prompts | prompts.csv | 30+ AI prompts |
| Charts | charts.csv | 20+ chart types |
| Naming | name_convention.csv | Naming conventions |

$3

- search.py - BM25 search CLI
- core.py - Search engine core

---

🔧 Development

If you want to contribute or modify the CLI:

`bash


Clone and install

git clone https://github.com/btLong402/flutter-skill.git
cd cli
npm install

Build the project

npm run build

Run locally

node dist/index.js init --ai claude

Test search

node dist/index.js init --ai claude
cd .claude/skills/flutter-pro-max
python3 scripts/search.py "ListView" --domain widget --top 3
`

---

📁 Project Structure

`
cli/
├── src/
│ ├── index.ts # CLI entry point
│ ├── commands/
│ │ ├── init.ts # Install command
│ │ ├── versions.ts # List versions
│ │ └── update.ts # Update command
│ ├── types/
│ │ └── index.ts # TypeScript types
│ └── utils/
│ ├── detect.ts # AI type detection
│ ├── github.ts # GitHub API client
│ ├── logger.ts # Console logger
│ └── template.ts # Template renderer
├── assets/
│ ├── data/ # 17 CSV knowledge files
│ ├── scripts/ # Python search scripts
│ └── templates/
│ ├── base/ # Markdown templates
│ │ ├── skill-content.md # Full template (~13KB)
│ │ ├── skill-content-10k.md # Compact (~5KB)
│ │ ├── skill-content-4k.md # Mini (~2KB)
│ │ └── quick-reference.md # Add-on (~2KB)
│ └── platforms/ # 16 platform JSON configs
├── package.json
└── tsconfig.json
`

---

📄 License

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

---

📝 Changelog

$3

- VS Code 1.109 Support: GitHub Copilot và VS Code sử dụng .github/skills/ format
- Breaking Change: Copilot/VS Code chuyển từ prompts/instructions sang Skills
- Full Install: Copilot và VS Code nay sử dụng full template (~15KB) thay vì mini

$3

- Flutter AI Rules: Cập nhật theo Flutter Official AI Rules
- Platform Limits: Tạo templates phù hợp với giới hạn từng platform
- skill-content.md (~13KB) - Full template
- skill-content-10k.md (~5KB) - Compact (Antigravity)
- skill-content-4k.md` (~2KB) - Mini (Copilot, VS Code)
- New Platforms: JetBrains AI (Junie), VS Code
- Native-First State: ValueNotifier/ChangeNotifier mặc định

$3

- Type Safety: Full Python type hints cho Pylance strict mode
- Python 3.10+: Minimum Python version updated
- Code Quality: Xóa unused imports, fix linter warnings

$3

- Phiên bản đầu tiên với 14 AI assistant support

---