FlutterSDK Docs README
The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the FlutterSDK Docs listing page.
FlutterSDK AI
AI coding skills for the FlutterSDK ecosystem.
Teach your AI assistant Wind UI, Magic Framework, and more, across every major coding tool.
Registry · Issues · Quick Start
Why?
AI coding assistants are powerful, but they don't know your frameworks. They hallucinate widget names, guess at API patterns, and miss conventions.
FlutterSDK AI fixes this. It gives your AI structured knowledge about Wind UI's className system, Magic Framework's Laravel-inspired architecture, and more, so it generates correct code on the first try.
One install, every tool:
| Tool | Integration |
|---|---|
| OpenCode | URL-based skill registry |
| Claude Code | Plugin + Marketplace |
| Cursor | Rules (.mdc) |
| Gemini CLI | Command templates (.toml) |
| VS Code Copilot | Instructions (.md) |
| Codex CLI | MCP config (~/.codex/config.toml) |
| Antigravity CLI | MCP config (~/.gemini/config/mcp_config.json) |
| Cline | MCP config (.mcp.json) |
| Roo Code | MCP config (.mcp.json) |
Skills
Five skills are available. See docs/SKILLS.md for full descriptions.
| Skill | Package | Upstream | What it covers |
|---|---|---|---|
wind-ui | fluttersdk_wind | fluttersdk/wind | W-prefix widgets, the className parser pipeline, WindRecipe variants, dark mode, responsive breakpoints, design culture |
magic-framework | magic | fluttersdk/magic | IoC container, 18 facades, Eloquent ORM, GoRouter routing, forms, auth, testing, 5 ecosystem plugins |
fluttersdk-dusk | fluttersdk_dusk | fluttersdk/dusk | E2E driver: dusk_* MCP tools and matching CLI commands to snap, tap, type, and screenshot a running Flutter app |
fluttersdk-telescope | fluttersdk_telescope | fluttersdk/telescope | Runtime inspector: 9 ring buffers for HTTP, logs, exceptions, events, gates, DB queries |
fluttersdk-artisan | fluttersdk_artisan | fluttersdk/artisan | CLI framework + stdio MCP server: substrate artisan_* tools, builtin commands, artisan_tinker |
Each skill mirrors its upstream package's own skills/ directory and arrives here when that package publishes a release. The exact synced version is the version: field in skills/<name>/SKILL.md, and skills/index.json is the machine-readable index; neither is duplicated in this table, so neither can drift from it.
MCP Server
mcp.fluttersdk.com exposes a single search-docs tool via Streamable HTTP.
Public, no auth required. Full client config snippets (Claude Code, Cursor,
OpenCode, Codex CLI, Gemini CLI, VS Code Copilot, and more) are in
docs/MCP.md.
For clients that only support stdio (Claude Desktop, older Codex CLI):
The npx bridge proxies stdio to the upstream HTTP server transparently.
Quick Start
Option 1: npx skills (Recommended)
The fastest way. Works with 40+ AI coding agents.
Option 2: Universal Installer
Option 3: Tool-Specific
OpenCode
Add the registry URL to your opencode.json:
Skills are fetched automatically and cached locally.
Claude Code
The plugin auto-registers:
- 5 skills (
/fluttersdk:wind-ui,/fluttersdk:magic-framework,/fluttersdk:fluttersdk-dusk,/fluttersdk:fluttersdk-telescope,/fluttersdk:fluttersdk-artisan) /fluttersdk:flutter-review, a review that runs in a subagent as an independent second pair of eyes and then fixes what it finds, plus/fluttersdk:flutter-testfluttersdk:flutter-reviewerandfluttersdk:flutter-reviewer-deepsubagents, invokable directly with@fluttersdkMCP server (HTTP transport tomcp.fluttersdk.com; no manual.mcp.jsonedit required)
Cursor
Activates automatically for all .dart files.
Gemini CLI
Use with /flutter-review and /flutter-test commands.
VS Code Copilot
How It Works
OpenCode: Fetches fluttersdk.github.io/ai/index.json, downloads listed skill files, caches locally.
Claude Code: Plugin manifest (.claude-plugin/plugin.json) makes the repo installable. Skills in skills/ are auto-discovered and namespaced under /fluttersdk:.
Deployment: Push to main → GitHub Actions deploys skills/ to GitHub Pages automatically.
Contributing
Adding a New Skill
- Create
skills/<skill-name>/SKILL.mdwith YAML frontmatter (name,description) - Add reference files in
skills/<skill-name>/references/ - Update
skills/index.json: list every file in thefilesarray - Bump version in
.claude-plugin/plugin.jsonand.claude-plugin/marketplace.json - Push to
main
See CLAUDE.md for the full specification.
Important: Every file must be listed in
index.json: OpenCode only downloads listed files. Forgetting a file means users get incomplete skills.
License
MIT. See LICENSE for details.
Built with care by FlutterSDK
If this saves you time, give it a star; it helps others discover it.