v0.5.0: Flutter - 17 skills, 5 rules, 12 MCP tools

New Flutter skills: mobile-flutter-project-setup,
mobile-flutter-navigation, mobile-flutter-run-on-device,
mobile-flutter-state-management.
New rule: mobile-performance (cross-framework RN + Flutter).

Made-with: Cursor

Author: TMHSDigital

.cursor-plugin/plugin.json

@@ -1,8 +1,8 @@
 {
   "name": "mobile-app-developer-tools",
   "displayName": "Mobile App Developer Tools",
-  "version": "0.4.0",
-  "description": "Mobile app development for Cursor, Claude Code, and MCP-compatible editors. 13 skills covering project setup, environment detection, device deployment, navigation, state management, component patterns, camera, AI, permissions, auth, push notifications, local storage, and API integration for React Native/Expo - plus 4 rules. Companion MCP server provides 12 tools.",
+  "version": "0.5.0",
+  "description": "Mobile app development for Cursor, Claude Code, and MCP-compatible editors. 17 skills covering React Native/Expo and Flutter - project setup, navigation, device deployment, state management, components, camera, AI, permissions, auth, push, storage, APIs - plus 5 rules. Companion MCP server provides 12 tools.",
   "author": {
     "name": "TMHSDigital",
     "url": "https://github.com/TMHSDigital"

CHANGELOG.md

@@ -2,6 +2,14 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.5.0] - 2026-04-03
+
+### Added
+
+- **4 new Flutter skills**: `mobile-flutter-project-setup` (guided flutter create with structure, linting, packages, flavors), `mobile-flutter-navigation` (GoRouter, shell routes, auth guards, deep links), `mobile-flutter-run-on-device` (USB/wireless debugging, hot reload, build modes), `mobile-flutter-state-management` (Riverpod, Bloc, Provider patterns)
+- **1 new rule**: `mobile-performance` (cross-framework performance anti-patterns for React Native and Flutter)
+- Totals: 17 skills, 5 rules, 12 MCP tools
+
 ## [0.4.0] - 2026-04-03
 
 ### Added

CLAUDE.md

@@ -4,7 +4,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ## Project Overview
 
-The **Mobile App Developer Tools** Cursor plugin is at **v0.4.0**. It helps developers go from zero to a running mobile app on their phone. Currently supports React Native/Expo with **13 skills**, **4 rules**, and a companion MCP server exposing **12 tools**. Flutter support is planned for v0.5.0.
+The **Mobile App Developer Tools** Cursor plugin is at **v0.5.0**. It helps developers go from zero to a running mobile app on their phone. Supports React Native/Expo and Flutter with **17 skills**, **5 rules**, and a companion MCP server exposing **12 tools**.
 
 ## Plugin Architecture
 
@@ -16,7 +16,9 @@ mcp-server/                  - MCP server with 12 tools
 packages/mobile-dev-tools/   - NPM package (stub for name claim)
 ```
 
-## Skills (13 total)
+## Skills (17 total)
+
+### React Native / Expo
 
 | Skill | Purpose |
 | --- | --- |
@@ -34,14 +36,24 @@ packages/mobile-dev-tools/   - NPM package (stub for name claim)
 | mobile-local-storage | AsyncStorage, expo-sqlite, expo-secure-store, MMKV; migrations and data cleanup |
 | mobile-api-integration | REST/GraphQL clients, React Query, auth headers, retry, offline queue, optimistic updates |
 
-## Rules (4 total)
+### Flutter
+
+| Skill | Purpose |
+| --- | --- |
+| mobile-flutter-project-setup | Guided flutter create with structure, linting, packages, flavors |
+| mobile-flutter-navigation | GoRouter: declarative routing, shell routes for tabs, auth guards, deep linking |
+| mobile-flutter-run-on-device | USB/wireless debugging, hot reload vs restart, build modes, troubleshooting |
+| mobile-flutter-state-management | Riverpod (recommended), Bloc, Provider, setState; async data, code generation |
+
+## Rules (5 total)
 
 | Rule | Scope | Purpose |
 | --- | --- | --- |
 | mobile-secrets.mdc | Global | Flags API keys, signing credentials, keystore passwords, Firebase config, EAS tokens |
 | mobile-platform-check.mdc | `.ts`, `.tsx` | Flags platform-specific APIs used without Platform.OS or Platform.select() guards |
 | mobile-image-assets.mdc | `.ts`, `.tsx`, `.json` | Flags oversized images, unoptimized formats, missing density variants, uncached remote images |
 | mobile-env-safety.mdc | `.ts`, `.tsx`, `.json` | Flags hardcoded production endpoints, missing EXPO_PUBLIC_ prefix, server-only secrets in client code |
+| mobile-performance.mdc | `.ts`, `.tsx`, `.dart` | Flags inline styles, missing list keys, unnecessary re-renders (RN); missing const constructors, inline widgets (Flutter) |
 
 ## Companion MCP Server
 

README.md

@@ -9,7 +9,7 @@
 </p>
 
 <p align="center">
-  <a href="https://github.com/TMHSDigital/Mobile-App-Developer-Tools/releases"><img src="https://img.shields.io/badge/version-0.4.0-0A84FF?style=for-the-badge&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCIgZmlsbD0id2hpdGUiPjxwYXRoIGQ9Ik0xMiAyTDIyIDEyTDEyIDIyTDIgMTJaIi8+PC9zdmc+" alt="Release"></a>
+  <a href="https://github.com/TMHSDigital/Mobile-App-Developer-Tools/releases"><img src="https://img.shields.io/badge/version-0.5.0-0A84FF?style=for-the-badge&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCIgZmlsbD0id2hpdGUiPjxwYXRoIGQ9Ik0xMiAyTDIyIDEyTDEyIDIyTDIgMTJaIi8+PC9zdmc+" alt="Release"></a>
   <a href="https://creativecommons.org/licenses/by-nc-nd/4.0/"><img src="https://img.shields.io/badge/License-CC%20BY--NC--ND%204.0-lightgrey?style=for-the-badge" alt="License"></a>
   <a href="https://github.com/TMHSDigital/Mobile-App-Developer-Tools/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/TMHSDigital/Mobile-App-Developer-Tools/ci.yml?branch=main&label=CI&logo=githubactions&style=for-the-badge" alt="CI"></a>
   <a href="https://github.com/TMHSDigital/Mobile-App-Developer-Tools/actions/workflows/validate.yml"><img src="https://img.shields.io/github/actions/workflow/status/TMHSDigital/Mobile-App-Developer-Tools/validate.yml?branch=main&label=Validate&logo=githubactions&style=for-the-badge" alt="Validate"></a>
@@ -24,7 +24,7 @@
 ---
 
 <p align="center">
-  <strong>13 skills</strong> &nbsp;&bull;&nbsp; <strong>4 rules</strong> &nbsp;&bull;&nbsp; <strong>12 MCP tools</strong>
+  <strong>17 skills</strong> &nbsp;&bull;&nbsp; <strong>5 rules</strong> &nbsp;&bull;&nbsp; <strong>12 MCP tools</strong>
 </p>
 
 <p align="center">
@@ -35,7 +35,7 @@
 
 ## Overview
 
-Mobile App Developer Tools is a **Cursor** plugin by **TMHSDigital** that packages agent skills, editor rules, and a TypeScript **MCP server** (`mcp-server/`) so you can scaffold, run, and debug mobile apps without leaving the IDE. Currently at **v0.4.0** with thirteen skills, four rules, and twelve live MCP tools. Flutter support is planned for v0.5.0.
+Mobile App Developer Tools is a **Cursor** plugin by **TMHSDigital** that packages agent skills, editor rules, and a TypeScript **MCP server** (`mcp-server/`) so you can scaffold, run, and debug mobile apps without leaving the IDE. Currently at **v0.5.0** with seventeen skills (React Native/Expo + Flutter), five rules, and twelve live MCP tools.
 
 <br>
 <table>
@@ -46,8 +46,8 @@ Mobile App Developer Tools is a **Cursor** plugin by **TMHSDigital** that packag
 
 | Layer | Role |
 | --- | --- |
-| **Skills** | Guided workflows: project scaffolding, environment setup, device deployment, navigation, state, components, camera, AI, permissions, auth, push, storage, APIs |
-| **Rules** | Guardrails: `mobile-secrets` catches hardcoded secrets; `mobile-platform-check` flags missing guards; `mobile-image-assets` flags bloat; `mobile-env-safety` flags env issues |
+| **Skills** | 17 guided workflows for React Native/Expo and Flutter: project setup, navigation, device deploy, state, components, camera, AI, permissions, auth, push, storage, APIs |
+| **Rules** | 5 guardrails: secrets, platform guards, image bloat, env safety, performance anti-patterns (RN + Flutter) |
 | **MCP** | Twelve tools for environment checks, project creation, device connection, screen/component generation, dependency install, permissions, AI, build health, push, deep links, dev reset |
 
 </td>
@@ -61,7 +61,7 @@ Mobile App Developer Tools is a **Cursor** plugin by **TMHSDigital** that packag
 | **Author** | [TMHSDigital](https://github.com/TMHSDigital) |
 | **Repository** | [github.com/TMHSDigital/Mobile-App-Developer-Tools](https://github.com/TMHSDigital/Mobile-App-Developer-Tools) |
 | **Runtime** | Node 20+ for MCP server |
-| **Framework** | Expo (React Native) + TypeScript |
+| **Framework** | Expo (React Native) + Flutter |
 
 </td>
 </tr>
@@ -152,10 +152,10 @@ Open Cursor and ask:
 
 ## Skills
 
-All 13 skills are production-ready. Names match the folder under `skills/`.
+All 17 skills are production-ready. Names match the folder under `skills/`.
 
 <details>
-<summary><strong>All 13 skills</strong></summary>
+<summary><strong>React Native / Expo skills (13)</strong></summary>
 
 | Skill | Framework | What it does |
 | --- | --- | --- |
@@ -175,6 +175,18 @@ All 13 skills are production-ready. Names match the folder under `skills/`.
 
 </details>
 
+<details>
+<summary><strong>Flutter skills (4)</strong></summary>
+
+| Skill | What it does |
+| --- | --- |
+| `mobile-flutter-project-setup` | Guided `flutter create` with feature-first structure, linting, packages, flavors |
+| `mobile-flutter-navigation` | GoRouter: declarative routing, shell routes for tabs, auth guards, deep linking |
+| `mobile-flutter-run-on-device` | USB/wireless debugging, hot reload vs restart, build modes, troubleshooting |
+| `mobile-flutter-state-management` | Riverpod (recommended), Bloc, Provider, setState; async data, code generation |
+
+</details>
+
 **Example prompts** - one per skill:
 
 | Skill | Try this |
@@ -192,22 +204,27 @@ All 13 skills are production-ready. Names match the folder under `skills/`.
 | `mobile-push-notifications` | "Set up push notifications that open a specific screen on tap" |
 | `mobile-local-storage` | "I need offline storage for a todo list with secure login" |
 | `mobile-api-integration` | "Connect to my REST API with auth headers and offline support" |
+| `mobile-flutter-project-setup` | "Create a new Flutter app with Riverpod and GoRouter" |
+| `mobile-flutter-navigation` | "Add tab navigation with GoRouter in my Flutter app" |
+| `mobile-flutter-run-on-device` | "My Android phone doesn't show up in flutter devices" |
+| `mobile-flutter-state-management` | "Should I use Riverpod or Bloc for my Flutter app?" |
 
 ---
 
 ## Rules
 
-All 4 rules are production-ready.
+All 5 rules are production-ready.
 
 <details>
-<summary><strong>All 4 rules</strong></summary>
+<summary><strong>All 5 rules</strong></summary>
 
 | Rule | Scope | What it catches |
 | --- | --- | --- |
 | `mobile-secrets` | Always on | API keys, signing credentials, keystore passwords, Firebase config, `.p8`/`.p12` files, EAS tokens |
 | `mobile-platform-check` | `.ts`, `.tsx` | Platform-specific APIs (BackHandler, ToastAndroid, StatusBar methods) used without `Platform.OS` or `Platform.select()` guards |
 | `mobile-image-assets` | `.ts`, `.tsx`, `.json` | Oversized images (>500KB), unoptimized formats (BMP, TIFF), missing `@2x`/`@3x` variants, uncached remote images |
 | `mobile-env-safety` | `.ts`, `.tsx`, `.json` | Hardcoded production endpoints, missing `EXPO_PUBLIC_` prefix, server-only secrets in client code |
+| `mobile-performance` | `.ts`, `.tsx`, `.dart` | Inline styles, missing list keys, ScrollView for long lists (RN); missing const constructors, inline widgets (Flutter) |
 
 </details>
 
@@ -293,7 +310,7 @@ Plugin manifest: [`.cursor-plugin/plugin.json`](.cursor-plugin/plugin.json).
 
 ## Configuration
 
-No API keys are required for v0.4.0. All tools work locally.
+No API keys are required for v0.5.0. All tools work locally.
 
 Future versions may use:
 
@@ -314,8 +331,8 @@ Summary aligned with [ROADMAP.md](ROADMAP.md):
 | **v0.1.0** | Zero to Phone | 3 skills, 1 rule, 3 MCP tools | |
 | **v0.2.0** | Navigate & State | 6 skills, 2 rules, 6 MCP tools | |
 | **v0.3.0** | Camera & AI | 9 skills, 3 rules, 9 MCP tools | |
-| **v0.4.0** | Users & Data | 13 skills, 4 rules, 12 MCP tools | **Current** |
-| **v0.5.0** | Flutter | Flutter project setup, navigation, device deploy, state management | |
+| **v0.4.0** | Users & Data | 13 skills, 4 rules, 12 MCP tools | |
+| **v0.5.0** | Flutter | 17 skills, 5 rules, 12 MCP tools | **Current** |
 | **v0.6.0** | Ship It | App store prep, iOS and Android submission | |
 | **v0.7.0** | Grow | Monetization, deep links, bundle analysis | |
 | **v1.0.0** | Stable | 22 skills, 7 rules, 18 MCP tools | |

ROADMAP.md

@@ -7,8 +7,8 @@
 | **v0.1.0** | Zero to Phone | 3 | 1 | 3 | Project scaffolding, env check, run-on-device, secrets rule |
 | **v0.2.0** | Navigate & State | +3 | +1 | +3 | Navigation setup, state management, component generation, platform-check rule |
 | **v0.3.0** | Camera & AI | +3 | +1 | +3 | Camera integration, AI features, permissions skill, image-assets rule |
-| **v0.4.0** | Users & Data | +4 | +1 | +3 | Auth, push notifications, local storage, API integration, env-safety rule **(current)** |
-| **v0.5.0** | Flutter | +4 | +1 | +0 | Flutter project setup, navigation, run-on-device, state management, performance rule |
+| **v0.4.0** | Users & Data | +4 | +1 | +3 | Auth, push notifications, local storage, API integration, env-safety rule |
+| **v0.5.0** | Flutter | +4 | +1 | +0 | Flutter project setup, navigation, run-on-device, state management, performance rule **(current)** |
 | **v0.6.0** | Ship It | +3 | +1 | +3 | App store prep, iOS submission, Android submission, accessibility rule |
 | **v0.7.0** | Grow | +2 | +0 | +3 | Monetization, deep links, build-for-store, screenshots, bundle analysis |
 | **v1.0.0** | Stable | +0 | +0 | +0 | Polish, docs, production release: 22 skills, 7 rules, 18 MCP tools |
@@ -58,7 +58,7 @@
 - `mobile_integrateAI` - Add AI API integration with error handling
 - `mobile_checkBuildHealth` - Verify the project builds cleanly
 
-## v0.4.0 - Users & Data (current)
+## v0.4.0 - Users & Data
 
 **Skills:**
 - `mobile-auth-setup` (Shared) - Auth patterns with Supabase, Firebase, Clerk
@@ -74,7 +74,7 @@
 - `mobile_configureDeepLinks` - Set up universal links and app links
 - `mobile_resetDevEnvironment` - Clear caches, reinstall pods, reset Metro/Gradle
 
-## v0.5.0 - Flutter
+## v0.5.0 - Flutter (current)
 
 **Skills:**
 - `mobile-project-setup` (Flutter) - Guided `flutter create` with recommended structure

mcp-server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tmhs/mobile-mcp",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "MCP server for mobile app development - 12 tools for environment checks, project scaffolding, device deployment, screen/component generation, dependency installation, permissions, AI integration, build health, push notifications, deep links, and dev environment reset.",
   "type": "module",
   "main": "dist/index.js",

mcp-server/src/index.ts

@@ -18,7 +18,7 @@ import { register as registerResetDevEnvironment } from "./tools/resetDevEnviron
 
 const server = new McpServer({
   name: "mobile-mcp",
-  version: "0.4.0",
+  version: "0.5.0",
 });
 
 registerCheckDevEnvironment(server);

packages/mobile-dev-tools/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tmhs/mobile-dev-tools",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "CLI and utilities for mobile app development - environment checks, project scaffolding, store metadata validation.",
   "type": "module",
   "main": "dist/index.js",

packages/mobile-dev-tools/src/index.ts

@@ -1,3 +1,3 @@
-export const VERSION = "0.4.0";
+export const VERSION = "0.5.0";
 
 export const PACKAGE_NAME = "@tmhs/mobile-dev-tools";