Skip to content

Commit b397ca3

Browse files
committed
v0.12.0: Extend & Evolve - 3 skills, 1 rule, 3 MCP tools
Skills: mobile-native-modules, mobile-config-plugins, mobile-sdk-upgrade Rule: mobile-native-compat (deprecated native APIs, bridge-only patterns, New Architecture) MCP tools: mobile_createNativeModule, mobile_upgradeSDK, mobile_checkNativeCompat Totals: 43 skills, 12 rules, 36 MCP tools Made-with: Cursor
1 parent bac7e11 commit b397ca3

File tree

16 files changed

+1715
-29
lines changed

16 files changed

+1715
-29
lines changed

.cursor-plugin/plugin.json

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
{
22
"name": "mobile-app-developer-tools",
33
"displayName": "Mobile App Developer Tools",
4-
"version": "0.11.0",
5-
"description": "Mobile app development for Cursor, Claude Code, and MCP-compatible editors. 40 skills covering React Native/Expo and Flutter - project setup through app store submission, monetization, analytics, OTA updates, testing, CI/CD, animations, maps, i18n, forms, real-time, security, offline sync, background tasks, debugging, production monitoring, theming, feature flags, and accessibility testing - plus 11 rules. Companion MCP server provides 33 tools.",
4+
"version": "0.12.0",
5+
"description": "Mobile app development for Cursor, Claude Code, and MCP-compatible editors. 43 skills covering React Native/Expo and Flutter - project setup through app store submission, monetization, analytics, OTA updates, testing, CI/CD, animations, maps, i18n, forms, real-time, security, offline sync, background tasks, debugging, production monitoring, theming, feature flags, accessibility testing, native modules, config plugins, and SDK upgrades - plus 12 rules. Companion MCP server provides 36 tools.",
66
"author": {
77
"name": "TMHSDigital",
88
"url": "https://github.com/TMHSDigital"

CHANGELOG.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,15 @@
22

33
All notable changes to this project will be documented in this file.
44

5+
## [0.12.0] - 2026-04-04
6+
7+
### Added
8+
9+
- **3 new skills**: `mobile-native-modules` (Expo Modules API, Turbo Modules, JSI bridging, native view components, Swift/Kotlin), `mobile-config-plugins` (config plugin authoring, CNG patterns, Xcode/Gradle automation, modifier previews), `mobile-sdk-upgrade` (SDK version migration, dependency audit, breaking change detection, rollback strategy, expo-doctor)
10+
- **1 new rule**: `mobile-native-compat` (flags deprecated native APIs, bridge-only module patterns, New Architecture incompatibilities, sunset React Native APIs)
11+
- **3 new MCP tools**: `mobile_createNativeModule`, `mobile_upgradeSDK`, `mobile_checkNativeCompat`
12+
- Totals: 43 skills, 12 rules, 36 MCP tools
13+
514
## [0.11.0] - 2026-04-03
615

716
### Added

CLAUDE.md

Lines changed: 12 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
44

55
## Project Overview
66

7-
The **Mobile App Developer Tools** Cursor plugin is at **v0.11.0**. It helps developers go from zero to a published app in the stores. Supports React Native/Expo and Flutter with **40 skills**, **11 rules**, and a companion MCP server exposing **33 tools**.
7+
The **Mobile App Developer Tools** Cursor plugin is at **v0.12.0**. It helps developers go from zero to a published app in the stores. Supports React Native/Expo and Flutter with **43 skills**, **12 rules**, and a companion MCP server exposing **36 tools**.
88

99
## Demo App
1010

@@ -16,11 +16,11 @@ The **Mobile App Developer Tools** Cursor plugin is at **v0.11.0**. It helps dev
1616
.cursor-plugin/plugin.json - Plugin manifest
1717
skills/<skill-name>/SKILL.md - AI workflow definitions
1818
rules/<rule-name>.mdc - Code quality and security rules
19-
mcp-server/ - MCP server with 33 tools
19+
mcp-server/ - MCP server with 36 tools
2020
packages/mobile-dev-tools/ - NPM package (stub for name claim)
2121
```
2222

23-
## Skills (40 total)
23+
## Skills (43 total)
2424

2525
### React Native / Expo
2626

@@ -76,8 +76,11 @@ packages/mobile-dev-tools/ - NPM package (stub for name claim)
7676
| mobile-theming | Design tokens, dark mode, system appearance detection, NativeWind, Material 3, persistent preference |
7777
| mobile-feature-flags | Feature toggles with PostHog, LaunchDarkly, Firebase Remote Config; A/B testing, staged rollouts |
7878
| mobile-accessibility-testing | Automated a11y audits, WCAG compliance, screen reader testing, CI integration |
79+
| mobile-native-modules | Expo Modules API (Swift/Kotlin), Turbo Modules, JSI bridging, native view components |
80+
| mobile-config-plugins | Config plugin authoring, CNG patterns, Xcode/Gradle automation, modifier previews |
81+
| mobile-sdk-upgrade | SDK version migration, dependency audit, breaking change detection, rollback strategy |
7982

80-
## Rules (11 total)
83+
## Rules (12 total)
8184

8285
| Rule | Scope | Purpose |
8386
| --- | --- | --- |
@@ -92,12 +95,13 @@ packages/mobile-dev-tools/ - NPM package (stub for name claim)
9295
| mobile-i18n-strings.mdc | `.ts`, `.tsx`, `.dart` | Flags hardcoded user-facing strings not wrapped in a translation function |
9396
| mobile-security-audit.mdc | `.ts`, `.tsx`, `.dart`, `.json`, `.xml` | Flags insecure storage, missing SSL pinning, debug flags in release builds, cleartext traffic |
9497
| mobile-color-contrast.mdc | `.ts`, `.tsx`, `.dart` | Flags insufficient color contrast, missing dark mode variants, non-semantic color usage |
98+
| mobile-native-compat.mdc | `.ts`, `.tsx`, `.dart` | Flags deprecated native APIs, bridge-only patterns, New Architecture incompatibilities |
9599

96100
## Companion MCP Server
97101

98102
Tools use the `mobile_` prefix (for example `mobile_checkDevEnvironment`).
99103

100-
### Tools (33 total)
104+
### Tools (36 total)
101105

102106
| Tool | Description |
103107
| --- | --- |
@@ -134,6 +138,9 @@ Tools use the `mobile_` prefix (for example `mobile_checkDevEnvironment`).
134138
| mobile_setupTheming | Initialize design token system with light/dark themes, semantic colors, and persistent preference |
135139
| mobile_auditAccessibility | Scan project for a11y violations: missing labels, small touch targets, images without alt text |
136140
| mobile_setupFeatureFlags | Add typed feature flag provider with default values, remote sync, and provider integration |
141+
| mobile_createNativeModule | Scaffold an Expo Module or Flutter plugin with Swift/Kotlin stubs and TS/Dart bindings |
142+
| mobile_upgradeSDK | Generate SDK upgrade plan with dependency fixes, breaking changes, and rollback strategy |
143+
| mobile_checkNativeCompat | Audit packages for New Architecture support, flag bridge-only and deprecated dependencies |
137144

138145
## Development Workflow
139146

README.md

Lines changed: 25 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@
99
</p>
1010

1111
<p align="center">
12-
<a href="https://github.com/TMHSDigital/Mobile-App-Developer-Tools/releases"><img src="https://img.shields.io/badge/version-0.11.0-0A84FF?style=for-the-badge&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCIgZmlsbD0id2hpdGUiPjxwYXRoIGQ9Ik0xMiAyTDIyIDEyTDEyIDIyTDIgMTJaIi8+PC9zdmc+" alt="Release"></a>
12+
<a href="https://github.com/TMHSDigital/Mobile-App-Developer-Tools/releases"><img src="https://img.shields.io/badge/version-0.12.0-0A84FF?style=for-the-badge&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCIgZmlsbD0id2hpdGUiPjxwYXRoIGQ9Ik0xMiAyTDIyIDEyTDEyIDIyTDIgMTJaIi8+PC9zdmc+" alt="Release"></a>
1313
<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>
1414
<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>
1515
<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 @@
2424
---
2525

2626
<p align="center">
27-
<strong>40 skills</strong> &nbsp;&bull;&nbsp; <strong>11 rules</strong> &nbsp;&bull;&nbsp; <strong>33 MCP tools</strong>
27+
<strong>43 skills</strong> &nbsp;&bull;&nbsp; <strong>12 rules</strong> &nbsp;&bull;&nbsp; <strong>36 MCP tools</strong>
2828
</p>
2929

3030
<p align="center">
@@ -35,15 +35,15 @@
3535

3636
## Overview
3737

38-
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, build, and ship mobile apps without leaving the IDE. Currently at **v0.11.0** with forty skills (React Native/Expo + Flutter), eleven rules, and thirty-three live MCP tools.
38+
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, build, and ship mobile apps without leaving the IDE. Currently at **v0.12.0** with forty-three skills (React Native/Expo + Flutter), twelve rules, and thirty-six live MCP tools.
3939

4040
**What you get**
4141

4242
| Layer | Role |
4343
| --- | --- |
44-
| **Skills** | 40 guided workflows for React Native/Expo and Flutter: project setup through monetization, analytics, OTA updates, testing, CI/CD, animations, maps, i18n, forms, real-time, security, offline sync, background tasks, debugging, production monitoring, theming, feature flags, and accessibility testing |
45-
| **Rules** | 11 guardrails: secrets, platform guards, image bloat, env safety, performance, accessibility, bundle size, test coverage, i18n strings, security audit, color contrast |
46-
| **MCP** | 33 tools: env checks, scaffolding, device deploy, screen/component gen, permissions, AI, build health, push, deep links, store builds, metadata validation, App Store + Play Store submission, screenshots, bundle analysis, OTA config, test runner, CI setup, test file generation, i18n setup, map integration, form generation, real-time client, security audit, performance profiling, offline readiness, APM monitoring, theming, accessibility audit, feature flags |
44+
| **Skills** | 43 guided workflows for React Native/Expo and Flutter: project setup through monetization, analytics, OTA updates, testing, CI/CD, animations, maps, i18n, forms, real-time, security, offline sync, background tasks, debugging, production monitoring, theming, feature flags, accessibility testing, native modules, config plugins, and SDK upgrades |
45+
| **Rules** | 12 guardrails: secrets, platform guards, image bloat, env safety, performance, accessibility, bundle size, test coverage, i18n strings, security audit, color contrast, native compatibility |
46+
| **MCP** | 36 tools: env checks, scaffolding, device deploy, screen/component gen, permissions, AI, build health, push, deep links, store builds, metadata validation, App Store + Play Store submission, screenshots, bundle analysis, OTA config, test runner, CI setup, test file generation, i18n setup, map integration, form generation, real-time client, security audit, performance profiling, offline readiness, APM monitoring, theming, accessibility audit, feature flags, native module scaffolding, SDK upgrade, native compat audit |
4747

4848
**Quick facts**
4949

@@ -61,7 +61,7 @@ Mobile App Developer Tools is a **Cursor** plugin by **TMHSDigital** that packag
6161
flowchart LR
6262
A[User asks mobile dev question] --> B[Cursor loads a Skill]
6363
B --> C{MCP server configured?}
64-
C -->|Yes| D["mobile-mcp tools (33)"]
64+
C -->|Yes| D["mobile-mcp tools (36)"]
6565
C -->|No| E[Docs-only guidance]
6666
D --> F[Local env checks / scaffolding]
6767
E --> G[Answer in chat or code edits]
@@ -144,15 +144,15 @@ Open Cursor and ask:
144144

145145
## Demo App
146146

147-
See the plugin in action: **[SnapLog](https://github.com/TMHSDigital/Demo-Mobile-App)** is a photo journal app built entirely using these skills and MCP tools. It exercises 16 of the 40 skills - from project scaffolding and navigation to camera capture, AI descriptions, local storage, and push notifications.
147+
See the plugin in action: **[SnapLog](https://github.com/TMHSDigital/Demo-Mobile-App)** is a photo journal app built entirely using these skills and MCP tools. It exercises 16 of the 43 skills - from project scaffolding and navigation to camera capture, AI descriptions, local storage, and push notifications.
148148

149149
[![Demo App](https://img.shields.io/badge/demo-SnapLog-0A84FF?style=flat-square&logo=github)](https://github.com/TMHSDigital/Demo-Mobile-App)
150150

151151
---
152152

153153
## Skills
154154

155-
All 40 skills are production-ready. Names match the folder under `skills/`.
155+
All 43 skills are production-ready. Names match the folder under `skills/`.
156156

157157
<details>
158158
<summary><strong>React Native / Expo skills (15)</strong></summary>
@@ -190,7 +190,7 @@ All 40 skills are production-ready. Names match the folder under `skills/`.
190190
</details>
191191

192192
<details>
193-
<summary><strong>Shared skills (21)</strong></summary>
193+
<summary><strong>Shared skills (24)</strong></summary>
194194

195195
| Skill | What it does |
196196
| --- | --- |
@@ -215,6 +215,9 @@ All 40 skills are production-ready. Names match the folder under `skills/`.
215215
| `mobile-theming` | Design tokens, dark mode, system appearance detection, NativeWind for RN, Material 3 for Flutter, persistent preference |
216216
| `mobile-feature-flags` | Feature toggles with PostHog, LaunchDarkly, Firebase Remote Config; A/B testing, staged rollouts, kill switches |
217217
| `mobile-accessibility-testing` | Automated a11y audits, WCAG 2.1 AA compliance, screen reader testing (VoiceOver/TalkBack), CI integration |
218+
| `mobile-native-modules` | Expo Modules API (Swift/Kotlin), Turbo Modules, JSI bridging, native view components, platform plugins |
219+
| `mobile-config-plugins` | Config plugin authoring, CNG patterns, Xcode/Gradle automation, modifier previews |
220+
| `mobile-sdk-upgrade` | SDK version migration, dependency audit, breaking change detection, rollback strategy |
218221

219222
</details>
220223

@@ -263,17 +266,20 @@ All 40 skills are production-ready. Names match the folder under `skills/`.
263266
| `mobile-theming` | "Add dark mode support with design tokens and system appearance detection" |
264267
| `mobile-feature-flags` | "Set up feature flags with PostHog so I can do staged rollouts" |
265268
| `mobile-accessibility-testing` | "Run an accessibility audit on my app and fix any WCAG violations" |
269+
| `mobile-native-modules` | "Create a native module to access the device gyroscope" |
270+
| `mobile-config-plugins` | "Add Apple Pay entitlement and a custom URL scheme via config plugins" |
271+
| `mobile-sdk-upgrade` | "Upgrade my Expo app from SDK 50 to the latest version" |
266272

267273
</details>
268274

269275
---
270276

271277
## Rules
272278

273-
All 11 rules are production-ready.
279+
All 12 rules are production-ready.
274280

275281
<details>
276-
<summary><strong>All 11 rules</strong></summary>
282+
<summary><strong>All 12 rules</strong></summary>
277283

278284
| Rule | Scope | What it catches |
279285
| --- | --- | --- |
@@ -288,6 +294,7 @@ All 11 rules are production-ready.
288294
| `mobile-i18n-strings` | `.ts`, `.tsx`, `.dart` | Hardcoded user-facing strings not wrapped in a translation function, string concatenation for sentences, missing plural forms |
289295
| `mobile-security-audit` | `.ts`, `.tsx`, `.dart`, `.json`, `.xml` | Insecure storage (tokens in AsyncStorage), missing SSL pinning, debug flags in release builds, cleartext traffic, hardcoded signing credentials |
290296
| `mobile-color-contrast` | `.ts`, `.tsx`, `.dart` | Insufficient color contrast ratios, missing dark mode variants, non-semantic color usage, hardcoded colors without theme tokens |
297+
| `mobile-native-compat` | `.ts`, `.tsx`, `.dart` | Deprecated native APIs, bridge-only module patterns, New Architecture incompatibilities, sunset React Native/Flutter APIs |
291298

292299
</details>
293300

@@ -322,7 +329,7 @@ npx @tmhs/mobile-mcp
322329
```
323330

324331
<details>
325-
<summary><strong>All 33 MCP tools</strong></summary>
332+
<summary><strong>All 36 MCP tools</strong></summary>
326333

327334
| Tool | Purpose |
328335
| --- | --- |
@@ -359,6 +366,9 @@ npx @tmhs/mobile-mcp
359366
| `mobile_setupTheming` | Initialize design token system with light/dark themes, semantic colors, spacing, typography, and persistent theme preference. |
360367
| `mobile_auditAccessibility` | Scan project for a11y violations: missing labels, small touch targets, images without alt text, color-only indicators. Reports WCAG level. |
361368
| `mobile_setupFeatureFlags` | Add typed feature flag provider with default values, remote sync, and provider integration (PostHog, LaunchDarkly, Firebase). |
369+
| `mobile_createNativeModule` | Scaffold an Expo Module or Flutter platform plugin with Swift/Kotlin stubs and TypeScript/Dart bindings. |
370+
| `mobile_upgradeSDK` | Detect current SDK version, generate step-by-step upgrade plan with dependency fixes, breaking changes, and rollback strategy. |
371+
| `mobile_checkNativeCompat` | Audit installed packages for New Architecture (Fabric/TurboModules) support. Flag bridge-only and deprecated dependencies. |
362372

363373
</details>
364374

@@ -425,8 +435,8 @@ Full details in [ROADMAP.md](ROADMAP.md).
425435
| **v0.8.0** | Test & Automate | 27 skills, 8 rules, 22 MCP tools | |
426436
| **v0.9.0** | Rich Features | 32 skills, 9 rules, 26 MCP tools | |
427437
| **v0.10.0** | Harden | 37 skills, 10 rules, 30 MCP tools | |
428-
| **v0.11.0** | Design & Adapt | 40 skills, 11 rules, 33 MCP tools | **Current** |
429-
| **v0.12.0** | Extend & Evolve | 43 skills, 12 rules, 36 MCP tools | |
438+
| **v0.11.0** | Design & Adapt | 40 skills, 11 rules, 33 MCP tools | |
439+
| **v0.12.0** | Extend & Evolve | 43 skills, 12 rules, 36 MCP tools | **Current** |
430440
| **v1.0.0** | Stable | 43 skills, 12 rules, 36 MCP tools | |
431441
| **v1.1.0** | Polish & Platform | 48 skills, 13 rules, 39 MCP tools | |
432442
| **v1.2.0** | Data & Payments | 53 skills, 14 rules, 43 MCP tools | |

ROADMAP.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -14,8 +14,8 @@
1414
| **v0.8.0** | Test & Automate | +3 | +1 | +3 | Unit/E2E testing, CI/CD pipelines, test file generation |
1515
| **v0.9.0** | Rich Features | +5 | +1 | +4 | Animations, maps/location, i18n, forms/validation, real-time/WebSockets |
1616
| **v0.10.0** | Harden | +5 | +1 | +4 | Security, offline-sync, background tasks, debugging, production APM |
17-
| **v0.11.0** | Design & Adapt | +3 | +1 | +3 | Theming/dark mode, feature flags/remote config, accessibility testing automation **(current)** |
18-
| **v0.12.0** | Extend & Evolve | +3 | +1 | +3 | Native module authoring, config plugins, SDK upgrade migration |
17+
| **v0.11.0** | Design & Adapt | +3 | +1 | +3 | Theming/dark mode, feature flags/remote config, accessibility testing automation |
18+
| **v0.12.0** | Extend & Evolve | +3 | +1 | +3 | Native module authoring, config plugins, SDK upgrade migration **(current)** |
1919
| **v1.0.0** | Stable | +0 | +0 | +0 | Polish, docs, production release: 43 skills, 12 rules, 36 MCP tools |
2020
| **v1.1.0** | Polish & Platform | +5 | +1 | +3 | Media handling, social sharing, biometrics, haptics, app lifecycle; privacy-compliance rule |
2121
| **v1.2.0** | Data & Payments | +5 | +1 | +4 | Payments/checkout, data visualization, widgets/shortcuts, error boundaries, network awareness |

mcp-server/package.json

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"name": "@tmhs/mobile-mcp",
3-
"version": "0.11.0",
4-
"description": "MCP server for mobile app development - 33 tools for environment checks, project scaffolding, device deployment, screen/component generation, dependency installation, permissions, AI integration, build health, push notifications, deep links, dev environment reset, store builds, metadata validation, App Store submission, Play Store submission, screenshot capture, bundle analysis, OTA update configuration, test execution, CI/CD setup, test file generation, i18n setup, map integration, form generation, real-time client setup, security auditing, performance profiling, offline readiness checks, APM monitoring setup, theming setup, accessibility auditing, and feature flag configuration.",
3+
"version": "0.12.0",
4+
"description": "MCP server for mobile app development - 36 tools for environment checks, project scaffolding, device deployment, screen/component generation, dependency installation, permissions, AI integration, build health, push notifications, deep links, dev environment reset, store builds, metadata validation, App Store submission, Play Store submission, screenshot capture, bundle analysis, OTA update configuration, test execution, CI/CD setup, test file generation, i18n setup, map integration, form generation, real-time client setup, security auditing, performance profiling, offline readiness checks, APM monitoring setup, theming setup, accessibility auditing, feature flag configuration, native module scaffolding, SDK upgrade planning, and native compatibility auditing.",
55
"type": "module",
66
"main": "dist/index.js",
77
"bin": {

0 commit comments

Comments
 (0)