Tools
Understanding Ramses.Engine Architecture
Ramses.Engine is not a standalone monolithic binary but rather an integrated collection of components and hooks embedded within your host React Native application (the superapp). Its core responsibility is executing miniapp business logic and rendering UI through high-performance native components. The architecture follows a three-tier model: the Host (your React Native SuperApp environment), the Bridge (the communication layer), and the Renderer (the native UI presentation layer). This design allows miniapps to leverage native performance while maintaining a lightweight footprint. Each miniapp runs within this structured ecosystem, benefiting from React Native's capabilities without requiring developers to build native modules themselves.
The Bridge: Central Communication Hub
The Bridge operates as the critical message broker connecting your miniapp's logic to native React Native functionality. It intercepts all messages from an internal WebView execution context, using a routing mechanism to handle different message types appropriately. When receiving UI-related messages, the Bridge updates its internal state, triggering the native Renderer to refresh the display. For rs.* prefixed messages requesting native capabilities (camera, storage, payments, etc.), the Bridge invokes the corresponding React Native module, captures the result, and returns it to the execution context. This bidirectional communication pattern ensures seamless integration between your JavaScript logic and native device features while maintaining state consistency.
Streamlined Development Experience
Ramses provides a rapid, iterative development workflow centered on state-preserving hot reloading. Using VS Code with official Ramses.SDK extensions allow you to build miniapps using three file types: .rxml for UI structure, .rxss for styling, and .js for business logic. The extensions deliver intelligent autocompletion, real-time validation, and a visual designer panel showing live previews as you code. Changes appear instantly without losing application state, dramatically accelerating your development cycle. This approach combines web-like development speed with native app performance, letting you focus on building features rather than managing build processes.
Ramses is our registered trademark. All other brands mentioned on our website are the property of their respective owners.