PopApp UI

A React Native component registry for Expo apps. Components are added as source code to the user's project via the CLI — like shadcn/ui, but for React Native with pure StyleSheet (no NativeWind, no Tailwind).

IMPORTANT: All CLI commands use npx popapp. The CLI handles dependency resolution, import transformation, and file installation automatically.

Principles

1. Use existing components first. Run npx popapp list before writing custom UI. Check references/components.md for the full catalog.
2. Compose, don't reinvent. Settings screen = Screen + List + Card. Onboarding flow = Onboarding + OptionGroup + Button. Dashboard = Screen + Card + Ticker + ProgressRing.
3. Use useTheme() for all colors. Never hardcode hex values like #007AFF. Always pull from theme tokens.
4. Use semantic color tokens. colors.destructive for errors, colors.success for confirmation — not raw color names.

Critical Rules

Styling — StyleSheet Only

PopApp uses StyleSheet.create() for static styles and inline theme colors. There is no className, no NativeWind, no Tailwind.