v0.4.0: Users and Data - 13 skills, 4 rules, 12 MCP tools

New skills: mobile-auth-setup, mobile-push-notifications,
mobile-local-storage, mobile-api-integration.
New rule: mobile-env-safety.
New MCP tools: addPushNotifications, configureDeepLinks,
resetDevEnvironment.

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

CHANGELOG.md

@@ -2,6 +2,15 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.4.0] - 2026-04-03
+
+### Added
+
+- **4 new skills**: `mobile-auth-setup` (Supabase, Firebase, Clerk auth with secure token storage), `mobile-push-notifications` (expo-notifications, EAS Push, Android channels), `mobile-local-storage` (AsyncStorage, SQLite, SecureStore, MMKV), `mobile-api-integration` (REST/GraphQL clients, React Query, offline, retry)
+- **1 new rule**: `mobile-env-safety` (flags hardcoded production endpoints, missing EXPO_PUBLIC_ prefix, server-only secrets in client code)
+- **3 new MCP tools**: `mobile_addPushNotifications`, `mobile_configureDeepLinks`, `mobile_resetDevEnvironment`
+- Totals: 13 skills, 4 rules, 12 MCP tools
+
 ## [0.3.0] - 2026-04-03
 
 ### Added

CLAUDE.md

@@ -4,19 +4,19 @@ 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.3.0**. It helps developers go from zero to a running mobile app on their phone. Currently supports React Native/Expo with **9 skills**, **3 rules**, and a companion MCP server exposing **9 tools** for environment checks, project scaffolding, device deployment, screen/component generation, dependency installation, permissions, AI integration, and build health checks. Flutter support is planned for v0.5.0.
+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.
 
 ## 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 9 tools
+mcp-server/                  - MCP server with 12 tools
 packages/mobile-dev-tools/   - NPM package (stub for name claim)
 ```
 
-## Skills (9 total)
+## Skills (13 total)
 
 | Skill | Purpose |
 | --- | --- |
@@ -29,20 +29,25 @@ packages/mobile-dev-tools/   - NPM package (stub for name claim)
 | mobile-camera-integration | expo-camera setup, permissions, photo capture, barcode scanning, video recording |
 | mobile-ai-features | AI API integration (OpenAI, Anthropic, Google) with backend proxy, vision, text, audio |
 | mobile-permissions | Cross-platform permission request patterns, rationale strings, denied/blocked handling |
+| mobile-auth-setup | Authentication with Supabase, Firebase, Clerk; secure token storage, protected routes |
+| mobile-push-notifications | expo-notifications, EAS Push, Android channels, deep link on tap, local notifications |
+| 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 (3 total)
+## Rules (4 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 |
 
 ## Companion MCP Server
 
 Tools use the `mobile_` prefix (for example `mobile_checkDevEnvironment`).
 
-### Tools (9 total)
+### Tools (12 total)
 
 | Tool | Description |
 | --- | --- |
@@ -55,6 +60,9 @@ Tools use the `mobile_` prefix (for example `mobile_checkDevEnvironment`).
 | mobile_addPermission | Add platform permission with iOS rationale string to app.json config plugins |
 | mobile_integrateAI | Scaffold AI API client with provider config, error handling, and TypeScript types |
 | mobile_checkBuildHealth | Validate app.json, check dependencies, verify TypeScript, detect native module issues |
+| mobile_addPushNotifications | Add expo-notifications plugin to app.json, create notification handler, configure Android channel |
+| mobile_configureDeepLinks | Set scheme, add Android intent filters, iOS associated domains, generate AASA template |
+| mobile_resetDevEnvironment | Nuclear reset: clear Metro cache, .expo dir, node_modules cache, optionally Pods and Gradle |
 
 ## 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.3.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.4.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>9 skills</strong> &nbsp;&bull;&nbsp; <strong>3 rules</strong> &nbsp;&bull;&nbsp; <strong>9 MCP tools</strong>
+  <strong>13 skills</strong> &nbsp;&bull;&nbsp; <strong>4 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.3.0** with nine skills, three rules, and nine 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.4.0** with thirteen skills, four rules, and twelve 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, navigation, state management, component patterns, camera, AI, permissions |
-| **Rules** | Guardrails: `mobile-secrets` catches hardcoded secrets; `mobile-platform-check` flags missing platform guards; `mobile-image-assets` flags bundle bloat |
-| **MCP** | Nine tools for environment checks, project creation, device connection, screen/component generation, dependency installation, permissions, AI integration, build health |
+| **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 |
+| **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>
 <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 (9)"]
+    C -->|Yes| D["mobile-mcp tools (12)"]
     C -->|No| E[Docs-only guidance]
     D --> F[Local env checks / scaffolding]
     E --> G[Answer in chat or code edits]
@@ -152,10 +152,10 @@ Open Cursor and ask:
 
 ## Skills
 
-All 9 skills are production-ready. Names match the folder under `skills/`.
+All 13 skills are production-ready. Names match the folder under `skills/`.
 
 <details>
-<summary><strong>All 9 skills</strong></summary>
+<summary><strong>All 13 skills</strong></summary>
 
 | Skill | Framework | What it does |
 | --- | --- | --- |
@@ -168,6 +168,10 @@ All 9 skills are production-ready. Names match the folder under `skills/`.
 | `mobile-camera-integration` | Expo | expo-camera setup, permissions, photo capture, barcode scanning, video recording |
 | `mobile-ai-features` | Shared | AI API integration (OpenAI, Anthropic, Google) with backend proxy, vision, text, audio |
 | `mobile-permissions` | Shared | Cross-platform permission requests, iOS rationale strings, denied/blocked state handling |
+| `mobile-auth-setup` | Shared | Authentication with Supabase, Firebase, Clerk; secure token storage, protected routes |
+| `mobile-push-notifications` | Expo | expo-notifications, EAS Push, Android channels, deep link on tap, local notifications |
+| `mobile-local-storage` | Shared | AsyncStorage, expo-sqlite, expo-secure-store, MMKV; migrations and data cleanup |
+| `mobile-api-integration` | Shared | REST/GraphQL clients, React Query, auth headers, retry, offline queue, optimistic updates |
 
 </details>
 
@@ -184,21 +188,26 @@ All 9 skills are production-ready. Names match the folder under `skills/`.
 | `mobile-camera-integration` | "Add a QR code scanner to my app" |
 | `mobile-ai-features` | "I want to take a photo and have AI describe what's in it" |
 | `mobile-permissions` | "How do I handle camera permission properly on iOS and Android?" |
+| `mobile-auth-setup` | "Add email/password auth with Supabase and protected routes" |
+| `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" |
 
 ---
 
 ## Rules
 
-All 3 rules are production-ready.
+All 4 rules are production-ready.
 
 <details>
-<summary><strong>All 3 rules</strong></summary>
+<summary><strong>All 4 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 |
 
 </details>
 
@@ -233,7 +242,7 @@ npx @tmhs/mobile-mcp
 ```
 
 <details>
-<summary><strong>All 9 MCP tools</strong></summary>
+<summary><strong>All 12 MCP tools</strong></summary>
 
 | Tool | Purpose |
 | --- | --- |
@@ -246,6 +255,9 @@ npx @tmhs/mobile-mcp
 | `mobile_addPermission` | Add a platform permission to app.json with iOS rationale string via Expo config plugins. |
 | `mobile_integrateAI` | Scaffold an AI API client with provider config, error handling, timeout, and TypeScript types. |
 | `mobile_checkBuildHealth` | Validate app.json, check dependencies, verify TypeScript compiles, detect native module issues. |
+| `mobile_addPushNotifications` | Add expo-notifications plugin to app.json, create notification handler, configure Android channel. |
+| `mobile_configureDeepLinks` | Set URL scheme, add Android intent filters, iOS associated domains, generate AASA template. |
+| `mobile_resetDevEnvironment` | Nuclear reset: clear Metro cache, .expo dir, node_modules cache, optionally Pods and Gradle. |
 
 </details>
 
@@ -281,7 +293,7 @@ Plugin manifest: [`.cursor-plugin/plugin.json`](.cursor-plugin/plugin.json).
 
 ## Configuration
 
-No API keys are required for v0.3.0. All tools work locally.
+No API keys are required for v0.4.0. All tools work locally.
 
 Future versions may use:
 
@@ -301,8 +313,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 | **Current** |
-| **v0.4.0** | Users & Data | Auth, push notifications, local storage, API integration | |
+| **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.6.0** | Ship It | App store prep, iOS and Android submission | |
 | **v0.7.0** | Grow | Monetization, deep links, bundle analysis | |

ROADMAP.md

@@ -6,8 +6,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 **(current)** |
-| **v0.4.0** | Users & Data | +4 | +1 | +3 | Auth, push notifications, local storage, API integration, env-safety 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.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 |
@@ -43,7 +43,7 @@
 - `mobile_generateComponent` - Create a component with props, styles, tests
 - `mobile_installDependency` - Add and configure a library with linking and pod install
 
-## v0.3.0 - Camera & AI (current)
+## v0.3.0 - Camera & AI
 
 **Skills:**
 - `mobile-camera-integration` (Expo) - expo-camera setup, permissions, photo capture
@@ -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
+## v0.4.0 - Users & Data (current)
 
 **Skills:**
 - `mobile-auth-setup` (Shared) - Auth patterns with Supabase, Firebase, Clerk

mcp-server/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tmhs/mobile-mcp",
-  "version": "0.3.0",
-  "description": "MCP server for mobile app development - 9 tools for environment checks, project scaffolding, device deployment, screen/component generation, dependency installation, permissions, AI integration, and build health checks.",
+  "version": "0.4.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",
   "bin": {

mcp-server/src/index.ts

@@ -12,10 +12,13 @@ import { register as registerInstallDependency } from "./tools/installDependency
 import { register as registerAddPermission } from "./tools/addPermission.js";
 import { register as registerIntegrateAI } from "./tools/integrateAI.js";
 import { register as registerCheckBuildHealth } from "./tools/checkBuildHealth.js";
+import { register as registerAddPushNotifications } from "./tools/addPushNotifications.js";
+import { register as registerConfigureDeepLinks } from "./tools/configureDeepLinks.js";
+import { register as registerResetDevEnvironment } from "./tools/resetDevEnvironment.js";
 
 const server = new McpServer({
   name: "mobile-mcp",
-  version: "0.3.0",
+  version: "0.4.0",
 });
 
 registerCheckDevEnvironment(server);
@@ -27,6 +30,9 @@ registerInstallDependency(server);
 registerAddPermission(server);
 registerIntegrateAI(server);
 registerCheckBuildHealth(server);
+registerAddPushNotifications(server);
+registerConfigureDeepLinks(server);
+registerResetDevEnvironment(server);
 
 async function main(): Promise<void> {
   const transport = new StdioServerTransport();