appCN
appCN
Copy-paste mobile components for React Native + Expo.
A shadcn-philosophy library: you own the source, NativeWind styles the surface, Reanimated drives the motion — and the featured AI-native collection ships streaming bubbles, prompt composers, reasoning traces, and a reactive 3D voice orb.
Browse components · CLI docs · Mobile app · Live showcase · GitHub
Quick start
The CLI handles NativeWind + Reanimated wiring and registers the @app-cn
shadcn namespace for you. One command to set up, one to add a component.
# 1. (Recommended) One-shot project setup
npx @app-cn/cli@latest init
# 2. Add any component by slug
npx @app-cn/cli@latest add voice-spherePrefer your own pipeline? appcn add is a thin wrapper around shadcn — you can
skip the CLI entirely:
# Copy a single component via shadcn (no setup, one-off)
npx shadcn@latest add https://appcn.vercel.app/r/voice-sphere.json
# Or pull the whole library as a managed dep
npm install @app-cn/uiBuilding with an AI agent? Add the appCN MCP server so Claude Code, Cursor, or Windsurf can discover and install components for you — and write new code in appCN's motion/haptic style:
# Claude Code
claude mcp add appcn -- npx -y @app-cn/mcpSee MCP docs for Cursor / Windsurf / VS Code config.
Status: v0.1.0 live on npm. Five components shipped — the AI collection is the marketed wedge and is the first place to land new work.
Related MCP server: @registry/mcp
What's in the box
New: appCN is live on real phones — scan a QR with Expo Go and the entire component gallery loads on Android or iPhone in seconds. No emulator, no developer account. Standalone Play Store APK is in review — shipping soon.
Base
Component | Delight |
| Spring-y press scale to 0.96, settles in 140 ms — feels weighted, never twitchy |
AI-native
Component | Delight |
| Three-phase thinking → token stream → settle |
| Send morphs into a stop with a spinning ring |
| Auto-collapses the instant the answer lands |
| Reactive 3D orb that breathes with voice level |
Every component has an interactive web preview, a QR you can scan with Expo Go to run it live on your phone, and a video — same code path on every surface. → appcn.vercel.app/components
Why appCN
Real-phone previews. Scan a QR with Expo Go and the component runs live on your device with native gestures. No emulator gymnastics.
AI-native flagship. The AI collection is the wedge — components built for AI apps that nobody else ships well.
Quadruple distribution. The
appcnCLI, the shadcn registry,@app-cn/uifrom npm — or the MCP server, so your AI coding agent installs components for you. Same primitives, your call.Motion-first defaults. Reanimated + gesture-handler, shared motion tokens (
duration/easing/spring), one delight detail per component.Dark-mode first. Designed dark, then derived to light. Premium reads as depth, not rainbows.
You own the source. Copy-paste philosophy means no lock-in — once a component lands in your repo, edit freely.
Documentation
Surface | What's there |
Live docs site — landing, every component, live previews | |
| |
Play Store + Expo Go install paths, deep-link contract | |
Architecture, monorepo map, commands, Metro/Reanimated gotchas | |
Taste layer — motion rules, the "one delight detail" rule, the 8-step SOP | |
Dev setup, the Changesets release flow, PR conventions | |
Cross-tool guide for AI coding agents (Claude / Cursor / Windsurf / Codex / Aider) |
Contributing
Every new component ships through the 8-step SOP in DESIGN.md → Component checklist. Don't skip steps — the PR template enforces them and a missing changeset blocks the release pipeline.
Working with an AI agent? Invoke the /new-component Claude skill — it
walks the checklist, drops a typed <slug>.meta.ts template ready to fill,
wires the registry + showcase entries, and verifies with typecheck + registry
build.
Full guide: CONTRIBUTING.md.
Releases
Releases are driven by Changesets and published to npm via OIDC Trusted Publishing — zero long-lived secrets.
pnpm changeset # describe what changed + pick a bump
git commit -am "..." # commit the changeset alongside your code
# Open a PR. After merge to main, a "Version Packages" PR opens automatically.
# Merge that PR → CI publishes via OIDC.Every published version gets a verified provenance badge on npm.
Deploying
Project | Vercel root directory | What it serves |
Docs |
| Landing, |
Showcase |
| Expo web export — the iframe target for interactive previews |
Deploy order (matters):
Deploy the showcase first (
apps/showcase) so you have a URL.Deploy the docs, setting
NEXT_PUBLIC_SHOWCASE_WEB_URLto that URL.Optional: custom domains (
appcn.vercel.app→ docs,appcn-showcase.vercel.app→ showcase).
Required env vars (docs project):
Variable | Value |
|
|
| (empty for v1 — needs EAS Update for the QR tab) |
|
|
The showcase project needs no env vars. Defaults live in
apps/web/.env.example.
Acknowledgments
Inspired by shadcn/ui's copy-paste philosophy and react-native-reusables's docs-site polish. Built on top of NativeWind, Reanimated, and Expo.
License
MIT — you own the code.
Available Tools
5 toolsget_componentGet an appCN componentA
Everything an agent needs to add and correctly use one appCN component: its docs (anatomy, delight detail, props, usage examples, accessibility notes), the actual source file contents, the npm packages and registry helpers it depends on, and the install command. Prefer installing via the install command rather than pasting files by hand — that resolves dependencies for you.
Inputs: slug (required).
get_design_guideGet the appCN design guideA
appCN's taste layer: the motion duration/easing/spring tokens, the press-scale and haptics conventions, the variant API rules, accessibility requirements, and the explicit 'what NOT to do' list. Read this before writing or modifying any React Native component so the code feels like appCN — never hand-type durations or easings, reach for these tokens.
Inputs: no named parameters.
get_install_commandGet an appCN install commandA
The exact command to add an appCN component to a project. Returns three install methods — the appCN CLI (recommended; handles NativeWind + Reanimated setup), shadcn namespaced, and shadcn by URL (zero setup) — for the requested package manager (or all of them).
Inputs: slug (required), manager.
list_componentsList appCN componentsA
List every appCN component, optionally filtered by category. Returns each component's slug, title, category, one-line description, and its signature 'delight' detail. Start here to see what's available, then call get_component for the full source and docs.
Inputs: category.
search_componentsSearch appCN componentsA
Find appCN components by intent or keyword — e.g. 'chat input', 'voice indicator', 'streaming message', 'reasoning'. Returns ranked matches with their delight detail. Use get_component on the best match for the full source and docs.
Inputs: query (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool has a clearly distinct purpose: listing, searching, retrieving full component details, getting install commands, and reading design guidance. There is no meaningful overlap—even list_components and search_components differ explicitly by browse vs. intent-based discovery.
All tool names follow a consistent lowercase snake_case verb_noun convention: get_install_command, get_design_guide, list_components, search_components, get_component. The pattern is uniform and predictable.
Five tools is well-scoped for a component library server: discovery via list/search, detailed retrieval, install support, and design guidance. Each tool earns its place without redundancy or bloat.
The tool surface covers the full workflow of discovering, selecting, retrieving, installing, and correctly styling a component. With list, search, get, install, and design-guide tools, agents have everything needed to integrate appCN components without dead ends.
Maintenance
Related MCP Connectors
MCP registry & directory: search, find & install 31k+ MCP servers & tools. Catalog and marketplace.
Search and install 4,000+ security-scanned MCP servers from inside any MCP-aware AI client.
Hosted MCP server for live public-data APIs and Skills for AI agents.
Related MCP Servers
- AlicenseCqualityDmaintenanceMCP server for searching npm packages1252 npm16MIT
- AlicenseNot gradedqualityDmaintenanceUnified MCP server for searching, analyzing, and managing packages across npm, JSR, Deno, and multiple CDN providers with auto-detection.MIT
- AlicenseAqualityDmaintenanceMCP server that gives LLMs access to up-to-date mobile SDK documentation, package registry info, and GitHub issues.612 npmMIT
- AlicenseNot gradedqualityCmaintenanceMCP server for the hy-app component library, enabling AI editors to search components, retrieve APIs and examples, check platform support, access hooks and tools, and validate component usage.MIT