React Native on Hera
Run React Native application logic through a Fabric host that translates UI state into Hera scenes.
rn_host allows a React Native application to participate in Hera's retained composition. React updates application state in Hermes, and Fabric uses Yoga layout to produce mounting transactions for the native host. The host translates those transactions into retained Hera nodes, which the server composes and renders into the final display image.
React Native Bridge
JavaScript application and Hermes
↓
Fabric shadow tree and Yoga layout
↓
Mount observer → adapter → retained transaction sink
↓
C ABI client → Hera IPC → server compositionThe bridge runs as a Linux C++ program linked to the Rust FFI library. Its component behavior comes from the Hera host implementation, so registering an upstream React Native descriptor is only the starting point for supporting that component on this platform.
Integration Guides
Start with setup, then read runtime and surfaces and Fabric mounting.
After learning the mounting path, use Components and support to see which behavior the adapter currently supplies. Input and scrolling follows interaction back toward Fabric, while FFI boundary explains the memory and protocol contracts that connect the native and Rust layers.
Component Responsibilities
The host's layout and UI-state work prepares the description consumed by the server. Hera retains that description and controls composition timing, global input policy, Vulkan rendering, and DRM/KMS presentation. Keeping these roles separate allows React Native to use its normal layout machinery while the server remains authoritative over the display.
Application-side layout does not violate server-authoritative rendering. Direct client control of the display or an independent scanout loop would cross that boundary.
Current Code Paths
To follow this path in the checkout, look under the fabric, platform, and runtime subdirectories. Earlier references to flat paths such as src/fabric/runtime.cpp no longer identify the implementation. The source references on each guide name the current files.
Source Reference
The following files in the Hera checkout define the behavior described on this page.
react-native/rn_host/src/main.cppreact-native/rn_host/src/fabric/runtime/runtime.cppreact-native/rn_host/src/fabric/adapter/adapter.cpp