🚀 Flutter Pro Max CLI

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

📦 Installation

The Quick Way (Recommended)

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

npx flutter-pro-max-cli

Global Installation

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

# Install globally
npm install -g flutter-pro-max-cli

# Initialize in your project
flutter-pro-max init

🛠️ Usage

Interactive Setup

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

flutter-pro-max init

Scripted Installation

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

# 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

Other Commands

# 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

Data Files (17 domains)

| 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 |

Search Scripts

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

🔧 Development

If you want to contribute or modify the CLI:

# 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

v2.3.0 (2026-02-06)

• 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

v2.2.0 (2026-02-02)

• 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

v2.1.0 (2026-01-27)

• 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

v2.0.0

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

Streamline your Flutter development with AI-powered architectural intelligence.