Run any Skill in Manus with one click

$pwd:

expo-horizon

Name: Expo Horizon
Author: software-mansion-labs

// Software Mansion's guide for migrating Expo SDK apps to Meta Quest using expo-horizon packages. Use when adding Meta Quest or Meta Horizon OS support to an existing Expo or React Native project. Trigger on: Meta Quest, Horizon OS, Quest 2, Quest 3, Quest 3S, VR app, expo-horizon-core, expo-horizon-location, expo-horizon-notifications, build flavors for Quest, panel sizing, VR headtracking, Horizon App ID, quest build variant, isHorizonDevice, isHorizonBuild, migrate expo-location to Quest, migrate expo-notifications to Quest, Meta Horizon Store publishing, or any task involving running an Expo app on Meta Quest hardware.

Run Skill in Manus

$ git log --oneline --stat

stars:203

forks:7

updated:April 20, 2026 at 10:53

SKILL.md

readonly

related-skills.json

same repository

rnrepo.md

from "software-mansion-labs/skills"

Best practices for integrating and using RNRepo — Software Mansion's infrastructure for pre-built React Native library artifacts that reduces native build times by up to 2×. Use when setting up, configuring, or troubleshooting RNRepo in a React Native or Expo project. Trigger on: 'RNRepo', 'rnrepo', 'slow builds', 'build times', 'prebuilt artifacts', 'prebuilt libraries', '@rnrepo/expo-config-plugin', '@rnrepo/build-tools', 'prebuilds-plugin', 'rnrepo.config.json', 'DISABLE_RNREPO', 'packages.rnrepo.org', 'Maven prebuild', 'CocoaPods prebuild', 'xcframework prebuild', 'prebuild AAR', 'build from source', 'native compilation slow', 'Gradle plugin slow', 'pod install slow', 'CI build times'.

2026-05-14203

jsi.md

from "software-mansion-labs/skills"

React Native JSI (JavaScript Interface) — C++ API for interacting with the JS runtime. Use whenever the user asks about or writes C++ code that touches JSI types or patterns: jsi::Runtime, jsi::Value, jsi::Object, jsi::Function, jsi::Array, jsi::ArrayBuffer, jsi::String, jsi::Symbol, jsi::BigInt, jsi::PropNameID, jsi::HostObject, jsi::HostFunction, jsi::NativeState, jsi::WeakObject, jsi::Scope, JSIException, JSINativeException, JSError, HostFunctionType, createFromHostFunction, getHostObject, setNativeState, evaluateJavaScript, queueMicrotask, drainMicrotasks, setRuntimeData, getRuntimeData, ISerialization, rt.global(), jsi.h, jsi-inl.h, JSI binding, C++ native module, calling JS from C++, calling C++ from JS, HostObject destructor, shared_ptr, CallInvoker, invokeAsync, folly::dynamic with JSI, zero-copy ArrayBuffer, TurboModule C++ layer, Nitro Module, jsi::WithRuntimeDecorator, or any question about the boundary between C++ and the JavaScript engine in React Native.

2026-04-22203

react-native-best-practices.md

from "software-mansion-labs/skills"

Software Mansion's best practices for production React Native and Expo apps on the New Architecture. MUST USE before writing, reviewing, or debugging ANY code in a React Native or Expo project. If the working directory contains a package.json with react-native, expo, or expo-router as a dependency, this skill applies. Trigger on: any code task in a React Native/Expo project, 'React Native', 'Expo', 'New Architecture', 'Reanimated', 'Gesture Handler', 'react-native-svg', 'ExecuTorch', 'react-native-audio-api', 'react-native-enriched', 'Worklet', 'Fabric', 'TurboModule', 'WebGPU', 'react-native-wgpu', 'TypeGPU', 'GPU shader', 'WGSL', 'svg', 'animation', 'gesture', 'audio', 'rich text', 'AI model', 'multithreading', 'chart', 'vector', 'image filter', 'shared value', 'useSharedValue', 'runOnJS', 'scheduleOnRN', 'thread', 'worklet', or any question involving UI, graphics, native modules, or React Native threading and animation behavior. Also use when a more specific sub-skill matches.

2026-04-22203

typegpu.md

from "software-mansion-labs/skills"

TypeGPU is type-safe WebGPU in TypeScript. Use whenever the user writes, debugs, or designs TypeGPU code: 'use gpu' shader functions, tgpu.fn, buffers, textures, bind groups, compute and render pipelines, vertex layouts, slots, accessors, and any TypeGPU API. Shader logic and CPU-side resources are tightly coupled - handle both sides here even if the user only mentions one (e.g. "how do I write a shader", "how do I create a buffer"). Trigger on any mention of typegpu, tgpu, "use gpu", TypedGPU, or WebGPU code written using TypeGPU's schema API (d.*, tgpu.*, std.*). Do NOT trigger for raw WebGPU (using GPUDevice/GPURenderPipeline directly without tgpu), WGSL-only questions, Three.js, Babylon.js, or WebGL.

2026-04-21203

on-device-ai.md

from "software-mansion-labs/skills"

Best practices for building on-device AI features in React Native using React Native ExecuTorch. Use when the user wants to add AI to a mobile app without cloud dependencies: chatbots and assistants, image classification, object detection, OCR and document parsing, style transfer, image generation, speech-to-text, text-to-speech, voice activity detection, semantic search with embeddings, real-time camera AI with VisionCamera, or vision-language image understanding. Also use when the user mentions offline AI, on-device ML, privacy-preserving AI, reducing cloud API costs or latency, running models locally on mobile, or downloading and managing ML models. Covers react-native-executorch hooks (useLLM, useClassification, useObjectDetection, useOCR, useSemanticSegmentation, useInstanceSegmentation, useStyleTransfer, useTextToImage, useImageEmbeddings, useSpeechToText, useTextToSpeech, useVAD, useTextEmbeddings, useExecutorchModule), tool calling, structured output, VLMs, model loading, and resource management.

2026-04-20203

animations.md

from "software-mansion-labs/skills"

Production animation patterns for React Native using Reanimated 4, Skia, WebGPU, and TypeGPU. Covers CSS transitions, CSS animations, shared value animations, canvas animations with react-native-skia, GPU shader animations, layout animations, scroll-driven animations, interpolation, particle systems, procedural noise, SDF rendering, performance tuning, and accessibility. Trigger on: Reanimated, useSharedValue, useAnimatedStyle, withSpring, withTiming, withDecay, withRepeat, withSequence, CSS transition, CSS animation, layout animation, FadeIn, SlideIn, ZoomIn, LinearTransition, keyframe, interpolate, scrollTo, useFrameCallback, react-native-skia, Skia Canvas, Atlas, usePathInterpolation, usePathValue, useClock, useTexture, SKSL, interpolateColors, Picture API, canvas animation, sprite animation, WebGPU, react-native-wgpu, TypeGPU, GPU shader, WGSL, particle system, Perlin noise, SDF, Three.js, react-three-fiber, animation performance, or any request to animate UI in React Native.

2026-03-20203

package.json

"author": "software-mansion-labs"

"repository": "software-mansion-labs/skills"

View GitHub Repository View Creator Repositories

$ install --global

$ download --local

Run Skill in Manus

$ useful --forSOC

Software DevelopersComputer and Mathematical Occupations15-1252L4

name

expo-horizon

description

Software Mansion's guide for migrating Expo SDK apps to Meta Quest using expo-horizon packages. Use when adding Meta Quest or Meta Horizon OS support to an existing Expo or React Native project. Trigger on: Meta Quest, Horizon OS, Quest 2, Quest 3, Quest 3S, VR app, expo-horizon-core, expo-horizon-location, expo-horizon-notifications, build flavors for Quest, panel sizing, VR headtracking, Horizon App ID, quest build variant, isHorizonDevice, isHorizonBuild, migrate expo-location to Quest, migrate expo-notifications to Quest, Meta Horizon Store publishing, or any task involving running an Expo app on Meta Quest hardware.

Expo Horizon: Migrating Expo SDK to Meta Quest

Software Mansion's production guide for adding Meta Quest support to Expo apps using the expo-horizon packages.

This skill does not bundle a copy of the docs. For any task below, always webfetch the linked official README or Meta documentation page to get up-to-date installation steps, plugin options, API surface, and feature matrices. This skill only captures the decision tree, critical rules, and non-obvious gotchas that agents routinely miss.

Decision Tree

What do you need to do?
│
├── Starting from scratch or adding Quest support to an existing Expo app?
│   └── Follow the "Setup Workflow" below (do NOT auto-install location or
│       notifications packages) and webfetch: expo-horizon-core README
│       ├── Install expo-horizon-core
│       ├── Configure the config plugin (horizonAppId, panel size, supportedDevices)
│       ├── Add quest/mobile build scripts
│       ├── Add runtime device detection (isHorizonDevice, isHorizonBuild)
│       └── Detect expo-location / expo-notifications, then ASK before migrating
│
├── Need location services on Quest?
│   └── Webfetch: expo-horizon-location README
│       ├── Replace expo-location with expo-horizon-location
│       ├── Review the feature support matrix
│       └── Guard unsupported calls (heading, geocoding, geofencing, background)
│
├── Need push notifications on Quest?
│   └── Webfetch: expo-horizon-notifications README
│       ├── Replace expo-notifications with expo-horizon-notifications
│       ├── Configure horizonAppId in expo-horizon-core
│       ├── Use getDevicePushTokenAsync (Expo Push Service is not supported)
│       └── Skip badge counts (not supported on Quest)
│
└── Need to build, run, or publish for Quest?
    └── Webfetch: expo-horizon-core README (build variants) + Meta docs below
        ├── Build variants: questDebug, questRelease, mobileDebug, mobileRelease
        ├── Meta Quest Developer Hub (device management, sideloading)
        └── Meta Horizon Store manifest requirements

Setup Workflow (adding Quest support to an existing Expo app)

Follow these steps in order when the user asks to add Meta Quest support. Do not combine steps 2 and 3 into a single install command — the sibling packages require explicit user confirmation.

Install and configure expo-horizon-core.
- Run npx expo install expo-horizon-core.
- Ask the user for the config plugin values before writing them. Present all options in a single prompt so the user can paste custom values or accept defaults in one pass. Show each option on its own line with its default in brackets, e.g.:
  I'll add the expo-horizon-core config plugin to app.json. Please confirm or override each value (press Enter / reply "default" to accept the bracketed default):
  - supportedDevices [quest2|quest3|quest3s] — pipe-separated Quest devices your app supports (required for Meta Horizon Store submission).
  - horizonAppId [empty] — Meta Horizon application ID. Leave empty unless you plan to use push notifications; required by expo-horizon-notifications to issue device push tokens.
  - defaultWidth [1024dp] — Default panel width. Leave blank to omit.
  - defaultHeight [640dp] — Default panel height. Leave blank to omit. If you set width/height, make sure your Expo orientation matches (use "landscape" for wide panels).
  - disableVrHeadtracking [false] — Set true to omit the android.hardware.vr.headtracking manifest entry.
  - allowBackup [false] — Meta recommends false for sensitive data; set true only if you need Android backup in the Quest build.
- Only write the plugin config after the user replies. Omit any option the user left blank so the package's own default applies (don't write empty strings for horizonAppId, defaultWidth, or defaultHeight).
- Add quest / mobile build scripts to package.json.
- Run npx expo prebuild --clean.
- Webfetch the expo-horizon-core README for current option names and defaults before asking — the defaults above can change between releases.
Detect existing location / notification packages. Do NOT install the horizon equivalents yet.
- Read the project's package.json.
- Check dependencies and devDependencies for expo-location and expo-notifications.
- If neither is present, skip the rest of this workflow — the user has no migration to do.
For each detected package, ask the user before migrating.
- If expo-location is found, ask:
  
  "I found expo-location in your project. Do you want me to replace it with expo-horizon-location so location works on Meta Quest? (Quest has no GPS, heading, geocoding, or geofencing — unsupported calls will need to be guarded with ExpoHorizon.isHorizonDevice.)"
- If expo-notifications is found, ask:
  
  "I found expo-notifications in your project. Do you want me to replace it with expo-horizon-notifications so push notifications work on Meta Quest? This requires a horizonAppId in the core config plugin, uses Meta's push service (not the Expo Push Service), and does not support badge counts or getExpoPushTokenAsync."
- Present the questions together if both packages are present.
- Wait for an explicit answer before running any install or edit for these packages.
Only after the user confirms, perform the migration for the approved package(s):
- Install the horizon equivalent (npx expo install expo-horizon-location or expo-horizon-notifications).
- Uninstall the original (npm uninstall expo-location or expo-notifications).
- Update all import statements to the horizon package name.
- For notifications: ensure horizonAppId is set in the expo-horizon-core plugin config and add expo-horizon-notifications to the plugins array.
- Run npx expo prebuild --clean again.
- Webfetch the relevant README (location or notifications) for the full feature support matrix and guard unsupported calls behind ExpoHorizon.isHorizonDevice.
If the user declines a migration, leave the original package untouched and note in the summary that feature X (location / notifications) will not work on the quest build until migrated.

Critical Rules

Always install expo-horizon-core first. It is required by all other expo-horizon packages and sets up the quest/mobile build flavors that other packages depend on.
Never auto-install expo-horizon-location or expo-horizon-notifications. When adding Quest support, detect existing expo-location / expo-notifications dependencies in package.json and ask the user whether to migrate each one. Install and configure only the packages the user explicitly approves. See the Setup Workflow above.
Use quest build variants only on Meta Quest devices. Running questDebug or questRelease builds on standard Android phones is unsupported and will behave unexpectedly.
Set supportedDevices in the config plugin. This is required for Meta Horizon Store submission. Use pipe-separated values: "quest2|quest3|quest3s".
Run npx expo prebuild --clean after any plugin config change. The config plugin modifies native project files at prebuild time. Stale native projects will not reflect your changes.
Replace imports, not just packages. When migrating from expo-location or expo-notifications, update all import statements to use the new package names (expo-horizon-location, expo-horizon-notifications).
Quest has no GPS, magnetic sensors, or Geocoder. Features like heading, geocoding, reverse geocoding, and geofencing are unavailable on Quest. Guard these calls with ExpoHorizon.isHorizonDevice or ExpoHorizon.isHorizonBuild.
Push notifications require horizonAppId. Without it, getDevicePushTokenAsync will not return a valid token on Quest devices. Use getDevicePushTokenAsync (not getExpoPushTokenAsync) on Quest; send the returned { type: 'horizon', data } token to your backend and deliver via Meta's push service.
isHorizonDevice vs isHorizonBuild. Use isHorizonDevice for runtime hardware checks (physical Quest detection). Use isHorizonBuild for build-time feature gating (which native code was compiled in).
Expo Go is not supported. You must use custom development builds via npx expo prebuild.

Official References

Always webfetch the raw markdown (raw.githubusercontent.com/...) if the HTML view does not render the source; the raw URL is the source of truth.

Topic	Official source
Repo overview and package list	expo-horizon README
Install, config plugin options, runtime API, native module access	expo-horizon-core README
Location migration, limitations, feature support matrix	expo-horizon-location README
Push notifications migration, token types, feature support matrix	expo-horizon-notifications README
Example app wiring for all three packages	expo-horizon example README
Panel sizing guidelines (dp values, orientation, letterboxing)	Meta Panel Sizing
Meta Horizon Store manifest checklist for publishing	Publish Mobile Manifest
Device management, casting, sideloading, ADB	Meta Quest Developer Hub
Server-side push delivery via Meta's push service	Horizon OS push notifications

expo-horizon

More from this repository

More from this repository

Expo Horizon: Migrating Expo SDK to Meta Quest

Decision Tree

Setup Workflow (adding Quest support to an existing Expo app)

Critical Rules

Official References

Expo Horizon: Migrating Expo SDK to Meta Quest

Decision Tree

Setup Workflow (adding Quest support to an existing Expo app)

Critical Rules

Official References