0007. Lynx behind an engine adapter
- Status: Accepted (subject to the milestone 0 spike)
- Date: 2026-11-14
- Decided by: Mik (Tab 1, Architecture)
Context
The native path depends on an engine we do not control. Lynx is ByteDance's project, built for their apps first.
Decision
Lynx is the native engine for version 1, reached only through packages/engine and the native emitter's output, which targets ReactLynx first and direct element tables later. Lynx's own words stay inside the adapter. Flutter and Compose Multiplatform are the candidate replacements. The milestone 0 spike can overturn this record against the kill criteria in docs/plan/roadmap.md.
Consequences
tools/boundaries.yaml confines @lynx-js/* imports to packages/engine. If the spike fails, a superseding record names the replacement or the wrapped-web fallback.