v0.2.0: Navigate and State - 6 skills, 2 rules, 6 MCP tools

New skills: mobile-navigation-setup (Expo Router patterns),
mobile-state-management (Zustand/Jotai/React Query),
mobile-component-patterns (reusable architecture and testing).

New rule: mobile-platform-check (flags missing Platform.OS guards).

New MCP tools: mobile_generateScreen, mobile_generateComponent,
mobile_installDependency.

Added Cursor release-process rule for consistent future releases.

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.1.0",
-  "description": "Mobile app development for Cursor, Claude Code, and MCP-compatible editors. 3 skills covering project setup, environment detection, and device deployment for React Native/Expo - plus 1 rule. Companion MCP server provides 3 tools for environment checks, project scaffolding, and device connection.",
+  "version": "0.2.0",
+  "description": "Mobile app development for Cursor, Claude Code, and MCP-compatible editors. 6 skills covering project setup, environment detection, device deployment, navigation, state management, and component patterns for React Native/Expo - plus 2 rules. Companion MCP server provides 6 tools for environment checks, project scaffolding, device connection, screen generation, component generation, and dependency installation.",
   "author": {
     "name": "TMHSDigital",
     "url": "https://github.com/TMHSDigital"

.cursor/rules/release-process.mdc

@@ -0,0 +1,101 @@
+---
+description: Enforce the release checklist when preparing a new version. Ensures all version files, docs, and counts stay in sync.
+alwaysApply: false
+globs:
+  - "**/CHANGELOG.md"
+  - "**/ROADMAP.md"
+  - "**/.cursor-plugin/plugin.json"
+  - "**/mcp-server/package.json"
+  - "**/packages/mobile-dev-tools/package.json"
+---
+
+# Release Process
+
+When preparing a release, complete every step below in order. Do not tag or push until all steps pass.
+
+## 1. Version Bump (7 files)
+
+Update the version string in all of these files. They must match exactly.
+
+| File | Field |
+| --- | --- |
+| `.cursor-plugin/plugin.json` | `version` |
+| `mcp-server/package.json` | `version` |
+| `mcp-server/src/index.ts` | `version` in `new McpServer({...})` |
+| `packages/mobile-dev-tools/package.json` | `version` |
+| `packages/mobile-dev-tools/src/index.ts` | `VERSION` constant |
+| `CLAUDE.md` | version reference in first paragraph |
+| `README.md` | version badge URL (`version-X.Y.Z-`) |
+
+## 2. Update Counts
+
+Update skill, rule, and MCP tool counts in these files to match the actual files on disk:
+
+- `.cursor-plugin/plugin.json` - `description` field
+- `mcp-server/package.json` - `description` field
+- `CLAUDE.md` - counts in overview paragraph and tables
+- `README.md` - counts in header, badge area, section headers, and tables
+
+Count sources:
+- Skills: `ls skills/*/SKILL.md | wc -l`
+- Rules: `ls rules/*.mdc | wc -l`
+- MCP tools: count `register*` calls in `mcp-server/src/index.ts`
+
+## 3. Update CHANGELOG.md
+
+Add a new entry at the top following the existing format:
+
+```markdown
+## [X.Y.Z] - YYYY-MM-DD
+
+### Added
+- List new skills, rules, and MCP tools
+```
+
+## 4. Update ROADMAP.md
+
+Move the `**(current)**` marker from the previous version to the new version in the release plan table and the version detail section.
+
+## 5. Build
+
+```bash
+cd mcp-server && npm run build
+cd ../packages/mobile-dev-tools && npm run build
+```
+
+Both must compile without errors.
+
+## 6. Test
+
+```bash
+pytest tests/ -v --tb=short
+```
+
+All tests must pass. The test suite validates:
+- Plugin manifest structure and referenced paths
+- Skill YAML frontmatter (name, description, name matches directory)
+- Skill required sections (Trigger, Required Inputs, Workflow, Example Interaction, MCP Usage, Common Pitfalls)
+- Rule YAML frontmatter (description, alwaysApply)
+- Version consistency across plugin.json, package.json, and index.ts
+
+## 7. Commit
+
+Use this format (no @ mentions):
+
+```
+vX.Y.Z: Theme Name - N skills, N rules, N MCP tools
+
+Brief description of what was added.
+```
+
+## 8. Tag and Push
+
+```bash
+git push origin main
+git tag -a vX.Y.Z -m "vX.Y.Z - Theme: N skills, N rules, N MCP tools"
+git push origin vX.Y.Z
+```
+
+The tag push triggers:
+- `.github/workflows/release.yml` - creates GitHub Release with changelog
+- `.github/workflows/publish-npm.yml` - publishes to npm

CHANGELOG.md

@@ -2,6 +2,16 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.2.0] - 2026-04-03
+
+### Added
+
+- **3 new skills**: `mobile-navigation-setup` (Expo Router patterns), `mobile-state-management` (Zustand, Jotai, React Query), `mobile-component-patterns` (reusable component architecture)
+- **1 new rule**: `mobile-platform-check` (flags platform-specific APIs without Platform.OS guards)
+- **3 new MCP tools**: `mobile_generateScreen`, `mobile_generateComponent`, `mobile_installDependency`
+- Cursor release process rule at `.cursor/rules/release-process.mdc`
+- Totals: 6 skills, 2 rules, 6 MCP tools
+
 ## [0.1.0] - 2026-04-03
 
 ### Added

CLAUDE.md

@@ -4,43 +4,50 @@ 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.1.0**. It helps developers go from zero to a running mobile app on their phone. Currently supports React Native/Expo with **3 skills**, **1 rule**, and a companion MCP server exposing **3 tools** for environment checks, project scaffolding, and device deployment. Flutter support is planned for v0.5.0.
+The **Mobile App Developer Tools** Cursor plugin is at **v0.2.0**. It helps developers go from zero to a running mobile app on their phone. Currently supports React Native/Expo with **6 skills**, **2 rules**, and a companion MCP server exposing **6 tools** for environment checks, project scaffolding, device deployment, screen generation, component generation, and dependency installation. Flutter support is planned for v0.5.0.
 
 ## Plugin Architecture
 
 ```
 .cursor-plugin/plugin.json   - Plugin manifest
 skills/<skill-name>/SKILL.md - AI workflow definitions
 rules/<rule-name>.mdc        - Code quality and security rules
-mcp-server/                  - MCP server with 3 tools
+mcp-server/                  - MCP server with 6 tools
 packages/mobile-dev-tools/   - NPM package (stub for name claim)
 ```
 
-## Skills (3 total)
+## Skills (6 total)
 
 | Skill | Purpose |
 | --- | --- |
 | mobile-project-setup | Guided Expo project creation with TypeScript, file-based routing, ESLint |
 | mobile-dev-environment | Cross-platform dependency detection (Node, Watchman, Xcode, Android Studio, Expo CLI) |
 | mobile-run-on-device | Running on a physical device via Expo Go, dev builds, QR code, tunnel mode |
+| mobile-navigation-setup | Expo Router file-based navigation: tabs, stack, drawer, typed routes, deep linking |
+| mobile-state-management | When to use React state vs Zustand vs Jotai vs React Query; patterns and examples |
+| mobile-component-patterns | Reusable component architecture, compound components, StyleSheet vs NativeWind, testing |
 
-## Rules (1 total)
+## Rules (2 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 |
 
 ## Companion MCP Server
 
 Tools use the `mobile_` prefix (for example `mobile_checkDevEnvironment`).
 
-### Tools (3 total)
+### Tools (6 total)
 
 | Tool | Description |
 | --- | --- |
 | mobile_checkDevEnvironment | Detect installed tools, SDKs, simulators; report what is missing |
 | mobile_scaffoldProject | Generate a new Expo project from a template with chosen options |
 | mobile_runOnDevice | Start dev server and provide instructions for connecting a physical device |
+| mobile_generateScreen | Create a new Expo Router screen file with navigation wiring and boilerplate |
+| mobile_generateComponent | Create a React Native component with typed props, StyleSheet, and optional tests |
+| mobile_installDependency | Install a package via npx expo install with native module detection and warnings |
 
 ## Development Workflow
 

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.1.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.2.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>3 skills</strong> &nbsp;&bull;&nbsp; <strong>1 rule</strong> &nbsp;&bull;&nbsp; <strong>3 MCP tools</strong>
+  <strong>6 skills</strong> &nbsp;&bull;&nbsp; <strong>2 rules</strong> &nbsp;&bull;&nbsp; <strong>6 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.1.0** with three skills, one rule, and three 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.2.0** with six skills, two rules, and six live MCP tools. Flutter support is planned for v0.5.0.
 
 <br>
 <table>
@@ -46,9 +46,9 @@ Mobile App Developer Tools is a **Cursor** plugin by **TMHSDigital** that packag
 
 | Layer | Role |
 | --- | --- |
-| **Skills** | Guided workflows: project scaffolding, environment setup, device deployment |
-| **Rules** | Guardrails: `mobile-secrets` catches hardcoded API keys and signing credentials |
-| **MCP** | Three tools for environment checks, project creation, and device connection |
+| **Skills** | Guided workflows: project scaffolding, environment setup, device deployment, navigation, state management, component patterns |
+| **Rules** | Guardrails: `mobile-secrets` catches hardcoded secrets; `mobile-platform-check` flags missing platform guards |
+| **MCP** | Six tools for environment checks, project creation, device connection, screen/component generation, dependency installation |
 
 </td>
 <td>
@@ -74,7 +74,7 @@ Mobile App Developer Tools is a **Cursor** plugin by **TMHSDigital** that packag
 flowchart LR
     A[User asks mobile dev question] --> B[Cursor loads a Skill]
     B --> C{MCP server configured?}
-    C -->|Yes| D["mobile-mcp tools (3)"]
+    C -->|Yes| D["mobile-mcp tools (6)"]
     C -->|No| E[Docs-only guidance]
     D --> F[Local env checks / scaffolding]
     E --> G[Answer in chat or code edits]
@@ -152,16 +152,19 @@ Open Cursor and ask:
 
 ## Skills
 
-All 3 skills are production-ready. Names match the folder under `skills/`.
+All 6 skills are production-ready. Names match the folder under `skills/`.
 
 <details>
-<summary><strong>All 3 skills</strong></summary>
+<summary><strong>All 6 skills</strong></summary>
 
 | Skill | Framework | What it does |
 | --- | --- | --- |
 | `mobile-project-setup` | Expo | Guided project creation with TypeScript, file-based routing, ESLint |
 | `mobile-dev-environment` | Shared | Detect OS, check dependencies (Node, Watchman, Xcode, Android Studio), fix common issues |
 | `mobile-run-on-device` | Expo | Step-by-step for physical device via Expo Go, dev builds, QR code, tunnel mode |
+| `mobile-navigation-setup` | Expo | Expo Router file-based navigation: tabs, stack, drawer, typed routes, deep linking |
+| `mobile-state-management` | Shared | When to use React state vs Zustand vs Jotai vs React Query with code examples |
+| `mobile-component-patterns` | Shared | Reusable component architecture, compound components, StyleSheet vs NativeWind, testing |
 
 </details>
 
@@ -172,19 +175,23 @@ All 3 skills are production-ready. Names match the folder under `skills/`.
 | `mobile-project-setup` | "Set up a new Expo project for a camera app" |
 | `mobile-dev-environment` | "Is my Mac ready for iOS development?" |
 | `mobile-run-on-device` | "My phone can't connect to the dev server - help" |
+| `mobile-navigation-setup` | "Add tab navigation with Home, Search, and Profile tabs" |
+| `mobile-state-management` | "What state management should I use for my Expo app?" |
+| `mobile-component-patterns` | "Create a reusable Card component with header and footer" |
 
 ---
 
 ## Rules
 
-All 1 rule is production-ready.
+Both rules are production-ready.
 
 <details>
-<summary><strong>All 1 rule</strong></summary>
+<summary><strong>All 2 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 |
 
 </details>
 
@@ -219,13 +226,16 @@ npx @tmhs/mobile-mcp
 ```
 
 <details>
-<summary><strong>All 3 MCP tools</strong></summary>
+<summary><strong>All 6 MCP tools</strong></summary>
 
 | Tool | Purpose |
 | --- | --- |
 | `mobile_checkDevEnvironment` | Detect installed tools (Node, Expo CLI, Watchman, Xcode, Android Studio, JDK). Report what is missing with install instructions. |
 | `mobile_scaffoldProject` | Generate a new Expo project with TypeScript template and recommended config. |
 | `mobile_runOnDevice` | Start dev server and provide step-by-step instructions for connecting a physical device. |
+| `mobile_generateScreen` | Create a new Expo Router screen file with correct convention, navigation wiring, and boilerplate. |
+| `mobile_generateComponent` | Create a React Native component with typed props interface, StyleSheet, and optional test file. |
+| `mobile_installDependency` | Install a package via `npx expo install` with native module detection and Expo Go compatibility warnings. |
 
 </details>
 
@@ -261,7 +271,7 @@ Plugin manifest: [`.cursor-plugin/plugin.json`](.cursor-plugin/plugin.json).
 
 ## Configuration
 
-No API keys are required for v0.1.0. All tools work locally.
+No API keys are required for v0.2.0. All tools work locally.
 
 Future versions may use:
 
@@ -279,8 +289,8 @@ Summary aligned with [ROADMAP.md](ROADMAP.md):
 
 | Version | Theme | Highlights | Status |
 | --- | --- | --- | --- |
-| **v0.1.0** | Zero to Phone | 3 skills, 1 rule, 3 MCP tools | **Current** |
-| **v0.2.0** | Navigate & State | Navigation setup, state management, component generation | |
+| **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 | **Current** |
 | **v0.3.0** | Camera & AI | Camera integration, AI features, permissions | |
 | **v0.4.0** | Users & Data | Auth, push notifications, local storage, API integration | |
 | **v0.5.0** | Flutter | Flutter project setup, navigation, device deploy, state management | |

ROADMAP.md

@@ -4,16 +4,16 @@
 
 | Version | Theme | Skills | Rules | MCP Tools | Highlights |
 |---------|-------|--------|-------|-----------|------------|
-| **v0.1.0** | Zero to Phone | 3 | 1 | 3 | Project scaffolding, env check, run-on-device, secrets rule **(current)** |
-| **v0.2.0** | Navigate & State | +3 | +1 | +3 | Navigation setup, state management, component generation, platform-check rule |
+| **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 **(current)** |
 | **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 |
 | **v0.5.0** | Flutter | +4 | +1 | +0 | Flutter project setup, navigation, run-on-device, state management, performance rule |
 | **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 |
 
-## v0.1.0 - Zero to Phone (current)
+## v0.1.0 - Zero to Phone
 
 **Skills:**
 - `mobile-project-setup` - Guided Expo project creation with opinionated defaults
@@ -28,7 +28,7 @@
 - `mobile_scaffoldProject` - Generate a new Expo project from templates
 - `mobile_runOnDevice` - Start dev server and connect to a device
 
-## v0.2.0 - Navigate & State
+## v0.2.0 - Navigate & State (current)
 
 **Skills:**
 - `mobile-navigation-setup` (Expo) - Expo Router file-based navigation patterns

mcp-server/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tmhs/mobile-mcp",
-  "version": "0.1.0",
-  "description": "MCP server for mobile app development - 3 tools for environment checks, project scaffolding, and device deployment.",
+  "version": "0.2.0",
+  "description": "MCP server for mobile app development - 6 tools for environment checks, project scaffolding, device deployment, screen generation, component generation, and dependency installation.",
   "type": "module",
   "main": "dist/index.js",
   "bin": {

mcp-server/src/index.ts

@@ -6,15 +6,21 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { register as registerCheckDevEnvironment } from "./tools/checkDevEnvironment.js";
 import { register as registerScaffoldProject } from "./tools/scaffoldProject.js";
 import { register as registerRunOnDevice } from "./tools/runOnDevice.js";
+import { register as registerGenerateScreen } from "./tools/generateScreen.js";
+import { register as registerGenerateComponent } from "./tools/generateComponent.js";
+import { register as registerInstallDependency } from "./tools/installDependency.js";
 
 const server = new McpServer({
   name: "mobile-mcp",
-  version: "0.1.0",
+  version: "0.2.0",
 });
 
 registerCheckDevEnvironment(server);
 registerScaffoldProject(server);
 registerRunOnDevice(server);
+registerGenerateScreen(server);
+registerGenerateComponent(server);
+registerInstallDependency(server);
 
 async function main(): Promise<void> {
   const transport = new StdioServerTransport();