# Flutter Cursor Plugin

> Cursor plugin for production Flutter development and testing with Dart MCP and Figma MCP

- **Type:** MCP server
- **Install:** `agentstack add mcp-wreos-flutter-cursor-plugin`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Wreos](https://agentstack.voostack.com/s/wreos)
- **Installs:** 0
- **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Wreos](https://github.com/Wreos)
- **Source:** https://github.com/Wreos/flutter-cursor-plugin

## Install

```sh
agentstack add mcp-wreos-flutter-cursor-plugin
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# flutter-cursor-plugin

Open-source Cursor plugin for production Flutter development and testing.

## Quickstart (1-5 minutes)

1. Install/enable the plugin in Cursor.
2. Ensure Dart MCP is available (`dart mcp-server`) and keep `mcp.json` in this repo enabled.
3. Run one practical flow:
   - `implement-flutter-feature` for feature scaffolding and implementation.
   - `generate-flutter-tests` for unit/widget/bloc/Patrol E2E tests.
   - `review-flutter-code` for risk-focused review with mandatory security checks.
4. Use `prepare-mobile-release` and `setup-mobile-github-pipeline` before shipping Android/iOS builds.

Pre-release install:
- If plugin is not in Marketplace yet, follow `docs/pre-release-enable-plugin.md`.

## Value in 5 minutes

Use one copy-paste prompt to verify end-to-end value fast:

```text
Implement a profile editing feature in Flutter with clean architecture.
Then generate widget and bloc tests for the new feature.
Finally run a risk-focused review with security checks and list fixes by severity.
```

Expected outcome:
- Feature scaffold + implementation plan from `implement-flutter-feature`.
- Test generation flow from `generate-flutter-tests`.
- Risk and security findings from `review-flutter-code` + `security-review`.

Three ready-to-run scenarios:
1. Feature + tests + review:
   - `implement-flutter-feature` -> `generate-flutter-tests` -> `review-flutter-code`
2. Dependency upgrade safety pass:
   - `update-flutter-dependencies` -> `docs/dependency-upgrade-checklist.md`
3. Release readiness:
   - `prepare-mobile-release` -> `setup-mobile-github-pipeline`

Reference project layout:
- https://github.com/Wreos/flutter-cursor-plugin-example

## Manifest and compatibility

- Canonical manifest: `.cursor-plugin/plugin.json` (schema-aligned for Cursor plugins).
- Compatibility manifest kept for existing setups: `plugin.json`.
- MCP auto-configuration: `mcp.json` (Dart MCP server).
- Command naming: canonical commands only (no aliases).

## Compatibility matrix

- Cursor plugins: latest stable with plugin support.
- Flutter SDK: stable channel recommended.
- Dart SDK: must support `dart mcp-server`.
- Patrol: required only for Patrol E2E scenarios.
- Monorepo/workspace usage: see `docs/monorepo-workspace-guide.md`.

## What this plugin covers

- Flutter feature implementation with clean architecture defaults.
- Figma-to-Flutter implementation workflow with Figma MCP.
- Dart/Flutter analysis and code generation workflows with Dart MCP.
- Full testing strategy: unit, widget, bloc/cubit, and Patrol E2E.

## Core principles

- Keep business logic outside widgets.
- Prefer deterministic async and explicit state transitions.
- Keep selectors stable and tests behavior-first.
- Favor small, composable widgets and injected dependencies.

## Included assets

- **Release checklist**: `docs/official-release-checklist.md` for official/public release prep.
- **Release automation**: `docs/release-automation.md` for semver bump, changelog cut, tag, and GitHub Release publishing.
- **Security posture**: `docs/security-posture.md` for `/security-review` scope, false-positive handling, and CI integration.
- **Reference Flutter app layout**: https://github.com/Wreos/flutter-cursor-plugin-example
- **Prompt guardrails**: `docs/prompt-execution-guardrails.md`.
- **Validation matrix**: `docs/validation-matrix.md`.
- **Semantic quality gates**: `docs/semantic-quality-gates.md`.
- **Agents**
  - `flutter-app-builder` (general Flutter implementation)
  - `flutter-code-reviewer`
  - `flutter-mobile-release-manager`
  - `flutter-test-writer`
- **Commands**
  - `implement-flutter-feature`
  - `implement-figma-screen`
  - `scaffold-flutter-feature`
  - `generate-flutter-tests`
  - `migrate-flutter-code`
  - `resolve-flutter-build-error`
  - `review-flutter-code`
  - `update-flutter-dependencies`
  - `prepare-mobile-release`
  - `setup-mobile-github-pipeline`
  - `setup-flutter-environment`
  - `integrate-mobile-api`
  - `integrate-firebase`
  - `security-review`
  - `sync-official-flutter-ai-rules`
  - `write-widget-test`
  - `write-bloc-test`
  - `write-e2e-test`
- **Rules**
  - `rules/flutter-development-best-practices.mdc`
  - `rules/dart-effective-dart.mdc`
  - `rules/flutter-test-best-practices.mdc`
  - `rules/flutter-plugin-policy-priority.mdc`
- **Skills**
  - `skills/build-flutter-features/`
  - `skills/scaffold-flutter-architecture/`
  - `skills/release-mobile-apps/`
  - `skills/integrate-mobile-api/`
  - `skills/integrate-firebase/`
  - `skills/write-flutter-tests/`
  - `skills/review-flutter-code/`
  - `skills/debug-flutter-issues/`
  - `skills/migrate-flutter-code/`
  - `skills/update-flutter-dependencies/`
  - `skills/security-audit/`
  - `skills/sync-official-flutter-ai-rules/`
  - `skills/setup-flutter-environment/`

## MCP integrations

- **Dart MCP**: use for analysis, fix suggestions, formatting guidance, and project-aware Dart/Flutter workflows.
- **Figma MCP**: use when translating Figma nodes/screens to Flutter UI with higher visual fidelity.
- **Effective Dart**: align implementation with the official guidance at https://dart.dev/effective-dart.
- **Claude `/security-review` parity**: security workflow mirrors `anthropics/claude-code-security-review` patterns (diff-aware + false-positive filtering).
- **Official Flutter AI rules sync**: use `sync-official-flutter-ai-rules` to refresh upstream Flutter rules profiles.
- **Rule priority routing**: `rules/flutter-plugin-policy-priority.mdc` is the high-priority policy layer over synced official rules.

## Official documentation

- Flutter Android deployment: https://docs.flutter.dev/deployment/android
- Flutter iOS deployment: https://docs.flutter.dev/deployment/ios
- Firebase setup for Flutter: https://firebase.google.com/docs/flutter/setup
- Android App Bundle guide: https://developer.android.com/guide/app-bundle
- App Store Connect submission: https://developer.apple.com/help/app-store-connect/manage-submissions-to-app-review/submit-an-app
- Claude Code Security Review: https://github.com/anthropics/claude-code-security-review
- Cursor plugin schema: https://raw.githubusercontent.com/cursor/plugins/main/schemas/plugin.schema.json
- Flutter MCP server docs: https://docs.flutter.dev/ai/mcp-server
- Flutter AI docs: https://docs.flutter.dev/ai

## Requirements

- Flutter SDK and Dart tooling.
- Patrol (only if you run Patrol E2E tests).
- Dart MCP server configured in Cursor.
- Figma MCP server configured in Cursor for design implementation tasks.

## Usage

1. Enable this plugin in Cursor.
2. For feature work, use `flutter-app-builder` or `implement-flutter-feature`.
3. For design implementation, use `implement-figma-screen` (Figma MCP).
4. For testing, use `flutter-test-writer` or `generate-flutter-tests`.
5. For migrations, debugging, and reviews use dedicated commands:
   - `migrate-flutter-code`
   - `resolve-flutter-build-error`
   - `review-flutter-code`
   - `update-flutter-dependencies`
   - or use dedicated review agent: `flutter-code-reviewer`
6. For Android/iOS publication readiness use:
   - `flutter-mobile-release-manager`
   - `prepare-mobile-release`
   - `docs/mobile-app-publishing-checklist.md`
   - `setup-mobile-github-pipeline`
   - `docs/mobile-ci-pipeline-checklist.md`
7. For Firebase integration use:
   - `integrate-firebase`
   - `docs/firebase-integration-checklist.md`
8. For external backend API integration use:
   - `integrate-mobile-api`
9. For security audit and secrets scanning use:
   - `security-review`
   - `docs/security-audit-checklist.md`
   - `docs/security-posture.md`
10. Keep generated output aligned with plugin rules.
11. For dependency upgrades, also follow:
   - `docs/dependency-upgrade-checklist.md`
12. For monorepo/workspace setups, follow:
   - `docs/monorepo-workspace-guide.md`
13. To sync official Flutter AI rules profiles (`10k`/`4k`/`1k`), use:
   - `sync-official-flutter-ai-rules`
   - `docs/flutter-ai-rules-sync.md`
14. For automated release cut (version/changelog/tag/release), use:
   - `.github/workflows/release-automation.yml`
   - `docs/release-automation.md`
15. For deterministic local setup and SDK/MCP readiness, use:
   - `setup-flutter-environment`

Note: every code review flow includes mandatory security checks (OWASP MASVS-oriented).

## Top use cases

1. Architecture scaffolding for new feature modules (BLoC/Riverpod/Clean).
2. Test generation for unit/widget/bloc/Patrol E2E.
3. Migration and refactoring workflows (framework/API/state-management changes).
4. Debug and error resolution for Dart/Android/iOS/dependency failures.
5. Risk-focused code review against conventions and architecture rules.
6. Android/iOS publishing readiness with official Flutter + store submission checklists.
7. Production-ready Firebase integration workflow for Flutter apps.
8. GitHub Actions mobile CI pipeline setup for APK/AAB build automation.
9. Security audit and secrets scanner workflow via `/security-review`.
10. Safe Flutter/Dart dependency upgrades with deterministic validation and rollback.
11. Deterministic environment bootstrapping for Flutter SDK, MCP, and baseline checks.
12. External backend API integration with robust auth/error/retry patterns.

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Wreos](https://github.com/Wreos)
- **Source:** [Wreos/flutter-cursor-plugin](https://github.com/Wreos/flutter-cursor-plugin)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-wreos-flutter-cursor-plugin
- Seller: https://agentstack.voostack.com/s/wreos
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
