flutter-pro-max-cli

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