Big News: Socket raises $60M Series C at a $1B valuation to secure software supply chains for AI-driven development.Announcement
Sign In

flutter-pro-max-cli

Package Overview
Dependencies
Maintainers
1
Versions
20
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

flutter-pro-max-cli

CLI to install Flutter Pro Max skill for AI coding assistants

latest
npmnpm
Version
2.4.5
Version published
Weekly downloads
42
-80.37%
Maintainers
1
Weekly downloads
 
Created
Source

🚀 Flutter Pro Max CLI

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

npm version Downloads Node.js Version License: MIT

📦 Installation

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

npm Publish

The CLI can be published automatically from GitHub Actions via .github/workflows/npm-publish.yml.

Requirements:

  • Add NPM_TOKEN to repository secrets
  • Bump cli/package.json version before pushing to main
  • The workflow skips publish if that exact version already exists on npm

🤖 Supported AI Assistants

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

AssistantType FlagInstall TypeTemplateLimit
Claude CodeclaudeFullFull (~15KB)No Limit
Codex CLIcodexFullFull (~15KB)No Limit
ContinuecontinueFullFull (~15KB)No Limit
JetBrains AI (Junie)junieFullFull (~15KB)No Limit
Gemini CLIgeminiFullFull (~15KB)1M+ Tokens
OpenCodeopencodeFullFull (~15KB)No Limit
CodeBuddycodebuddyFullFull (~15KB)No Limit
TraetraeFullFull (~15KB)No Limit
Antigravity (Google)antigravityFullCompact (~5KB)12,000 chars
CursorcursorReferenceFull (~13KB)No Limit
WindsurfwindsurfReferenceFull (~13KB)No Limit
GitHub CopilotcopilotFullFull (~15KB)No Limit
VS CodevscodeFullFull (~15KB)No Limit
KirokiroReferenceFull (~13KB)No Limit
RooCoderoocodeReferenceFull (~13KB)No Limit
Qodo/QoderqoderReferenceFull (~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

Rules Files (19 modules)

TierRulesDescription
Foundation (5)01-05Skill usage, Code quality, Interaction flow, Consistency, Error handling
Code Quality (5)06-10Testing, Performance, Security, State Management, Naming
UX & Resilience (5)11-15Accessibility, Network resilience, Offline-first, Graceful degradation, Lifecycle
Product (4)16-19Google Play ASO, Compliance, Visuals, Architecture decisions

Rules are automatically generated into platform-specific locations:

  • Append mode (Claude, Copilot): Rules concatenated into existing file
  • Create mode (Cursor, Windsurf, others): Separate .mdc or .md files in rules folder

Data Files (17 domains)

DomainFileDescription
Widgetswidget.csv65+ Flutter widgets
Packagespackage.csv100+ packages với alternatives
Patternspatterns.csv110+ design patterns
Architecturearchitect.csvArchitecture layers
Performanceflutter-performance.csv35 optimization patterns
Accessibilitymobile-accessibility.csv35 accessibility patterns
UI Reasoningui-reasoning.csv35 app category decisions
Colorscolors.csv50+ color palettes
Typographytypography.csv40+ font pairings
Stylesstyles.csv60+ UI styles
UXux-guidelines.csv50+ UX rules
Iconsicons.csv100+ icon recommendations
Landinglanding.csv30+ landing patterns
Productsproducts.csv40+ product recommendations
Promptsprompts.csv30+ AI prompts
Chartscharts.csv20+ chart types
Namingname_convention.csvNaming 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

🔄 Syncing Assets (Rules & Data)

When you update rules or data files in the source directory, you must sync them to CLI assets before publishing.

Sync Rules Only

After adding/updating rules in src/flutter-pro-max/templates/base/rules/:

# Copy all rules to CLI
cp -r src/flutter-pro-max/templates/base/rules/* cli/assets/templates/base/rules/

# Verify sync
ls cli/assets/templates/base/rules/ | wc -l  # Should show 19 files

Sync All Assets (Complete)

Before publishing to npm:

# Sync data files (17 domains)
cp -r src/flutter-pro-max/data/* cli/assets/data/

# Sync scripts
cp -r src/flutter-pro-max/scripts/* cli/assets/scripts/

# Sync templates (skills + rules + platforms)
cp -r src/flutter-pro-max/templates/* cli/assets/templates/

# Verify
cd cli/assets
find . -type f | wc -l  # Should show significantly more files

Pre-Publish Checklist

  • All 19 rules present in cli/assets/templates/base/rules/
  • All 17 data files present in cli/assets/data/
  • All scripts present in cli/assets/scripts/
  • Version bumped in cli/package.json
  • No uncommitted changes in CLI files

⚠️ CRITICAL: Without syncing, users will not receive the latest rules/data when they run flutter-pro-max-cli

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

Keywords

flutter

FAQs

Package last updated on 14 May 2026

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts