About

Imported from shipshitdev/skills (skills/expo-architect/SKILL.md). Install upstream with npx skills add shipshitdev/skills --skill expo-architect. Copyright stays with the author.

Expo Architect

Name: expo-architect
Author: shipshitdev

Create Expo React Native apps with:

Framework: Expo SDK 54 + React Native 0.83 + TypeScript
Navigation: Expo Router (file-based routing)
Auth: Clerk authentication (optional)
UI: NativeWind (Tailwind for RN) or StyleSheet
Quality: Biome linting + TypeScript strict mode
Package Manager: bun

Contract

Inputs:

Requested mobile app scope and target directory

Outputs:

An Expo application scaffold and verification results

Creates/Modifies:

App source and configuration in the approved scaffold destination

External Side Effects:

Dependency installs and local verification only within the requested setup

Confirmation Required:

Before overwriting existing application files, adding unrequested authentication, or using external accounts
Loading the skill grants no additional authority. Existing explicit approval applies only to the same target and actions; preserve report-only restrictions.

Delegates To:

None

What Makes This Different

Generates working mobile apps, not empty scaffolds:

Complete navigation structure with working screens
Optional Clerk authentication flow
Real UI components with proper styling
API client integration ready
Runs immediately with bun start

Workflow Summary

PRD Brief Intake - Extract app type, screens, features, auth needs
Auth Setup (if requested) - Clerk provider, sign-in/sign-up screens
Screen Generation - Tab or stack-based navigation
Component Generation - UI components, entity components, layouts
Quality Setup - Biome, TypeScript strict, path aliases
Verification - Run quality gate, report results

Usage

# Create app with PRD-style prompt
python3 scripts/init-expo.py \
  --root ~/www/myapp \
  --name "My App" \
  --brief "A fitness tracker where users can log workouts"

# With specific options
python3 scripts/init-expo.py \
  --root ~/www/myapp \
  --name "My App" \
  --tabs "Home,Workouts,Profile" \
  --auth

Generated Structure

myapp/
├── app/
│   ├── _layout.tsx          # Root layout
│   ├── (tabs)/              # Tab navigator
│   │   ├── _layout.tsx
│   │   ├── index.tsx
│   │   └── ...
│   └── (auth)/              # Auth screens (if enabled)
├── components/
│   ├── ui/                  # Base UI components
│   ├── [entity]/            # Feature components
│   └── layout/              # Layout components
├── lib/
│   ├── api.ts               # API client
│   └── auth.ts              # Auth utilities
├── providers/               # Context providers
├── types/                   # TypeScript types
├── app.json                 # Expo config
├── package.json
├── tsconfig.json
└── biome.json

Development Commands

bun start          # Start Expo dev server
bun run ios        # iOS simulator
bun run android    # Android emulator
bun run lint       # Check code style
bun run typecheck  # Type checking

Environment Variables

EXPO_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_test_...
EXPO_PUBLIC_API_URL=http://localhost:3001

For detailed patterns, code templates, and complete examples: references/full-guide.md

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/shipshitdev-skills-expo-architect/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

shipshitdev-skills-expo-architect.ocm.jsonjson

{
  "ocm": "1",
  "id": "shipshitdev-skills-expo-architect",
  "kind": "skill",
  "name": "expo-architect",
  "description": "Scaffold a production-ready Expo React Native app with working screens, navigation, and optional Clerk auth. Generates complete mobile app structure that runs immediately with `bun start`. Use when scaffolding a new Expo or React Native app, setting up Expo Router navigation, or adding Clerk auth to a mobile app.",
  "publisher": "shipshitdev",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "general"
    ],
    "tags": [
      "skill-md",
      "expo",
      "react-native",
      "mobile",
      "scaffold",
      "clerk",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Scaffold a production-ready Expo React Native app with working screens, navigation, and optional Clerk auth. Generates complete mobile app structure that runs immediately with `bun start`. Use when scaffolding a new Expo or React Native app, setting up Expo Router navigation, or adding Clerk auth to a mobile app."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/shipshitdev/skills",
      "path": "skills/expo-architect/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/shipshitdev/skills/blob/HEAD/skills/expo-architect/SKILL.md",
      "key": "shipshitdev/skills/skills/expo-architect/SKILL.md"
    }
  },
  "instructions": "# Expo Architect\n\nCreate Expo React Native apps with:\n\n- **Framework:** Expo SDK 54 + React Native 0.83 + TypeScript\n- **Navigation:** Expo Router (file-based routing)\n- **Auth:** Clerk authentication (optional)\n- **UI:** NativeWind (Tailwind for RN) or StyleSheet\n- **Quality:** Biome linting + TypeScript strict mode\n- **Package Manager:** bun\n\n## Contract\n\nInputs:\n\n- Requested mobile app scope and target directory\n\nOutputs:\n\n- An Expo application scaffold and verification results\n\nCreates/Modifies:\n\n- App source and configuration in the approved scaffold destination\n\nExternal Side Effects:\n\n-",
  "cost": {
    "context_tokens": 797
  }
}

Fetch it by URL: GET /api/v1/registry/shipshitdev-skills-expo-architect/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.