Guides

Learn the state, layout, runtime, and verification patterns behind NatUI applications.

Common props covers layout, appearance, identity, and accessibility.
Controlled state explains optimistic native input and sequence acknowledgements.
App shell and data connects menus, navigation, lists, tables, and application state.
Overlays covers sheets, alerts, popovers, and dismissal.
Runtime modes compares the Node sidecar and embedded JavaScriptCore paths.
Testing and debugging documents contract tests and native debug messages.

NatUI uses the platform layout engine. Design for native semantics and equivalent capability instead of assuming pixel-identical output.