Duolith docs

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.