Skip to content

Shankulkarni/react-native-ai-plugin

Repository files navigation

react-native-ai-plugin

AI-guided React Native development for Claude Code, Cursor, Codex, and Gemini CLI.

14 skills · 7 agents · 4 AI tools · New Architecture

npm React Native TypeScript Expo Reanimated v3 Gesture Handler v2 Bun MIT


What this does

Installs React Native skills, agents, and hard rules into your AI coding tool. Once installed, your AI assistant knows the right stack (Expo Router, React Query, NativeWind, Reanimated v3) and refuses legacy patterns — on every project, without repeating yourself.


Setup (one-time)

Step 1 — Install the plugin

npx react-native-ai-plugin install

This scans for ~/.claude, ~/.cursor, ~/.codex, ~/.gemini and installs into whichever tools you have. You'll see a checkmark for each one that succeeded.

Note: If you want the rn-ai command available globally (for rn-ai update, rn-ai status, rn-ai uninstall), install it globally instead:

npm install -g react-native-ai-plugin
rn-ai install

The npx approach above is enough for a one-time install.

Step 2 — Scaffold a new app

Open Claude Code in an empty directory and say:

Scaffold a new Expo app

Claude will ask for your app name, bundle ID, auth type, and tab structure — then generate the full project: dependencies, config files, folder structure, EAS setup, and linting.

That's it. The plugin runs silently from here. Every time you start a task, Claude loads the relevant skill automatically.


Using skills in Claude Code

Skills are loaded on demand — only the relevant one enters context, the rest cost zero tokens.

Ask Claude naturally and it will pick the right skill:

What you say Skill loaded
"Scaffold a new Expo app" scaffold
"Add a login screen with email/password" auth
"Set up navigation with tabs and a stack" navigation
"Build a form with validation" forms
"Add a swipe gesture to dismiss" animations
"Wire up the API to this screen" data
"Set up EAS Build for TestFlight" eas
"Store the user token securely" storage
"Write tests for this component" testing
"Scan this code for bad patterns" deslop

Commands

Command What it does
rn-ai install Detect installed AI tools and install the plugin into each
rn-ai update Re-install with the latest plugin files
rn-ai status Show which tools have the plugin active
rn-ai uninstall Remove the plugin from all tools

These require a global install (npm install -g react-native-ai-plugin). The npx one-liner only runs install — it doesn't persist the rn-ai binary.


Skills

14 skills loaded on demand. Only the relevant skill enters context — the rest cost 0 tokens.

Skill What it covers
🏗️ scaffold New app setup end-to-end
🗺️ navigation Expo Router routes, layouts, typed paths, deep links
🎨 ui NativeWind v4, className props, shadcn-style components
📡 data React Query hooks, API modules, Zod schemas
📝 forms react-hook-form, field validation, form state
🗂️ state Zustand, global and local UI state
animations Reanimated v3 worklets, GestureDetector, GPU-only properties
🔑 auth Supabase Auth, session handling, protected routes
🚀 eas EAS Build profiles, store submissions, OTA updates
🔔 notifications Expo Notifications, push token setup
💾 storage MMKV, Expo FileSystem
🧪 testing Jest, React Native Testing Library, Maestro E2E
performance FlatList, bundle size, FPS targets, memoization
🧹 deslop AI slop detection, legacy bridge violations, code quality scan

Agents

7 specialists. Work solo or as a coordinated team.

╔══════════════════════════════════════════════════════════════════════╗
║                                                                      ║
║  📱 APP                      🔗 BACKEND                              ║
║  ─────────                   ────────                                ║
║  App Architect               Backend Integrator                      ║
║  Screen Developer                                                    ║
║  Navigation Architect        🎛️  ORCHESTRATION                       ║
║                              ────────────────                        ║
║  ✅ QUALITY                  Orchestrator                            ║
║  ────────                    (full feature lifecycle)                ║
║  Code Reviewer                                                       ║
║  EAS Engineer                                                        ║
║                                                                      ║
╚══════════════════════════════════════════════════════════════════════╝
Agent Role
🎯 orchestrator Coordinates feature work across the other agents
🏛️ app-architect App structure, navigation shape, data flow decisions
📱 screen-developer Screens, components, interactions
🗺️ navigation-architect Expo Router layouts, tab stacks, deep link config
🔗 backend-integrator React Query hooks, API modules, Zod validation schemas
🚀 eas-engineer EAS Build profiles, store submissions, OTA strategy
code-reviewer Catches New Architecture violations, bad patterns, skipped rules

Supported Tools

Tool Skills Agents Hard rules Config location
Claude Code ~/.claude/CLAUDE.md
Cursor .cursorrules
Codex ~/.codex/AGENTS.md
Gemini CLI ~/.gemini/AGENTS.md

Hard Rules

The plugin enforces these on every project, without you having to say them:

  ┌─────────────────────────────────────────────┐
  │  Architecture                               │
  │  New Architecture only — RN 0.76+           │
  │  No NativeModules, requireNativeComponent   │
  │  No UIManager                               │
  ├─────────────────────────────────────────────┤
  │  Navigation                                 │
  │  Expo Router typed routes only              │
  │  No string path concatenation               │
  ├─────────────────────────────────────────────┤
  │  Data Fetching                              │
  │  React Query — no useEffect for data        │
  ├─────────────────────────────────────────────┤
  │  Animations & Gestures                      │
  │  Reanimated v3 — no RN Animated API         │
  │  Gesture Handler v2 — no PanResponder       │
  ├─────────────────────────────────────────────┤
  │  Package Manager                            │
  │  bun always — bunx not npx                  │
  ├─────────────────────────────────────────────┤
  │  TypeScript                                 │
  │  Strict mode, type not interface            │
  │  No any, no as                              │
  └─────────────────────────────────────────────┘

Requirements

  • Node.js 18+
  • At least one of: Claude Code, Cursor, Codex, Gemini CLI

About

Write better React Native code from day one - opinionated Claude Code rules, New Architecture ready.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors