Call get-react-native-guide({ query: "describe the task" }) during a build when the exact topic is unknown. Call it with topic for a deterministic guide, or with no arguments to discover every available topic.
Recommended Calls During a Build
| Build moment | Example call |
|---|---|
| Starting an app | get-react-native-guide({ query: "set up a new Expo app and decide when to leave Expo Go" }) |
| Building a screen | get-react-native-guide({ query: "turn this Figma screen into reusable typed React Native components" }) |
| Looking for code | get-react-native-guide({ query: "code example for single-flight token refresh with Expo SecureStore" }) |
| Building an API | get-react-native-guide({ topic: "expo-api-route-recipes" }) |
| Adding purchases | get-react-native-guide({ query: "RevenueCat entitlement provider, restore purchases, and atomic usage credits" }) |
| Building voice | get-react-native-guide({ topic: "realtime-audio-recipes" }) |
| Building chat | get-react-native-guide({ topic: "chat-component-recipes" }) |
| Adding message reactions | get-react-native-guide({ topic: "reaction-system-recipes" }) |
| Adding structured mentions | get-react-native-guide({ topic: "rich-text-composer-recipes" }) |
| Receiving shares from other apps | get-react-native-guide({ topic: "share-extension-recipes" }) |
| Building a social feed | get-react-native-guide({ query: "microblog-style post cards, media, actions, composer, and people directory" }) |
| Adding navigation | get-react-native-guide({ query: "Expo Router protected routes with role-based access and deep links" }) |
| Choosing native UI | get-react-native-guide({ query: "should this settings screen use Expo UI universal components or React Native views" }) |
| Following Expo's native UI guidance | get-react-native-guide({ topic: "official-expo-native-ui" }) |
| Migrating a web app to native | get-react-native-guide({ topic: "official-expo-web-to-native" }) |
| Adding a native library | get-react-native-guide({ topic: "development-builds" }) |
| Shipping | get-react-native-guide({ query: "production EAS build, store submission, and rollback checklist" }) |
For a UI implementation, combine this with get-ui-principle for visual decisions and get-ux-principle for behavior. After implementation, call get-review-rules.
Guide Map
| Concern | Topic |
|---|---|
| Setup, Expo, project structure | react-native-foundations |
| Core components, Flexbox, StyleSheet, lists | components-and-styling |
| Maintainable screens and platform boundaries | react-native-component-architecture |
| Expo Router, presentations, auth, roles, deep links | react-native-navigation |
| Fetching, streaming, API routes, Supabase, hosting | data-and-backends |
| Expo UI, SwiftUI, Compose, native state | expo-native-ui |
| Semantic tokens and dark mode | react-native-theming |
| Reanimated, gestures, swipe actions | animation-and-gestures |
| Push setup and routing | push-notifications |
| Interactive notification actions | react-native-notification-actions |
| Expo dev clients and environments | development-builds |
| OTA updates, channels, workflows, rollback | eas-updates-and-workflows |
| Jest and Maestro | react-native-testing |
| Expo Modules, native views, widgets, extensions | native-modules-and-extensions |
| Purchases, entitlements, subscriptions, attribution | mobile-monetization |
| SDK upgrades, builds, stores, submission | react-native-release |
| Common production application shapes | production-template-patterns |
| Auth sessions, secure tokens, protected navigation | auth-session-recipes |
| Validated Expo API routes and provider adapters | expo-api-route-recipes |
| RevenueCat entitlements, restoration, usage credits | purchases-and-usage-recipes |
| Incoming shares, files, playback lifecycle | media-sharing-audio-recipes |
| WebRTC voice sessions and short-lived credentials | realtime-audio-recipes |
| Durable staged generation, persistence, resume | durable-generation-recipes |
| Platform files, Expo UI, native state | native-platform-recipes |
| Typed fetch, cancellation, retries, virtualized lists | react-native-data-client-recipes |
| Press, swipe, scroll, and reduced-motion code | react-native-animation-recipes |
| Message rows, reactions, composer, mentions, chat timeline | chat-component-recipes |
| Animated reaction pills, people details, optimistic cache updates | reaction-system-recipes |
| TenTap and TipTap WebView editor, typed mentions, pasted media | rich-text-composer-recipes |
| Expo share-extension config, durable intake, destination delivery | share-extension-recipes |
| Post cards, media, actions, composer, people and follows | social-feed-component-recipes |
Official Expo Skills Snapshot
The knowledge base indexes every skill and Markdown reference in Expo's official expo/skills package. The snapshot is pinned to commit 8bd359f and retains Expo's MIT license. Use an official- topic when you want the upstream Expo material.
| Official Expo skill | Deterministic topic |
|---|---|
| Project structure | official-expo-project-structure |
| Expo Router | official-expo-router |
| Native UI | official-expo-native-ui |
| Expo UI | official-expo-ui |
| Data fetching | official-expo-data-fetching |
| Tailwind setup | official-expo-tailwind-setup |
| DOM components | official-expo-dom |
| Web-to-native migration | official-expo-web-to-native |
| Expo Modules | official-expo-module |
| Brownfield integration | official-expo-brownfield |
| Development clients | official-expo-dev-client |
| Expo examples | official-expo-examples |
| App Clips | official-expo-app-clip |
| SDK upgrades | official-expo-upgrade |
| App-store submission | official-eas-app-stores |
| EAS Hosting | official-eas-hosting |
| EAS Workflows | official-eas-workflows |
| EAS Observe | official-eas-observe |
| EAS Update Insights | official-eas-update-insights |
| EAS Simulator | official-eas-simulator |
| Expo skill feedback | official-expo-skill-feedback |
The EAS topics explain commands that can publish, submit, deploy, or incur costs. Retrieve the guidance first, then ask for approval before running paid or state-changing operations. Use official-expo-skill-feedback only when the user explicitly asks to send feedback.
Code Recipe Topics
The recipe topics are designed for Context7-style retrieval: describe the task and the tool returns focused code plus the invariants around it. The examples use generic domain models and documented public APIs so an agent can adapt them without importing an application-specific brand or architecture.
Every recipe topic contains multiple fenced TypeScript or TSX examples. The seed workflow stores both complete guides and task-sized sections in foundational_docs, including their code fences. Semantic search boosts sections with code, and the MCP response preserves complete fenced blocks instead of cutting a snippet in half.
Use a natural-language query when one task crosses topics:
get-react-native-guide({
query: "build a social app with an anchored chat timeline, optimistic reactions, virtualized posts, media grids, and follow controls"
})
Public Documentation Baseline
The curated guides cover the same build lifecycle as the recipe map: project setup, components, navigation, data, native UI, theming, motion, notifications, development builds, updates, testing, native extensions, monetization, and release. Version-sensitive behavior is checked against current public documentation, including:
- Expo documentation
- Expo Router
- React Native documentation
- React Native accessibility
- React Native Gesture Handler
- React Native Reanimated
- TanStack Query for React Native
- RevenueCat React Native SDK
- Maestro documentation
- Apple App Store Review Guidelines
- Google Play policy center
Provenance
Better Design's curated guides use generic examples documented against the public APIs linked in each topic. The official Expo layer is clearly separated, version-pinned, and retains its upstream MIT license and per-file source links. Always verify package APIs, platform rules, and store requirements against the versions installed in the target application.