Vue Features Compatibility
Vue Lynx is built on the official Vue 3 runtime core (@vue/runtime-core), so you should expect your Vue code to just work. The core rendering path — Composition API, SFCs, reactivity, template directives — works the same way you'd expect from standard Vue, with no Lynx-specific adaptation required.
Below is a feature-by-feature breakdown of the Vue features we've verified on Lynx. Where Lynx-specific caveats exist, they are called out inline. For details on how the dual-thread architecture works under the hood, see Understanding the Dual-Thread Model.
Reactivity + Composables
Vue Lynx reuses 100% of Vue's reactivity core (@vue/reactivity). Every reactivity API works identically to standard Vue, with no Lynx-specific caveats or adaptations.
The example below demonstrates reactive() + toRefs(), and a useStopwatch() composable that encapsulates reactive state:
SFC CSS Features
Plain <style> blocks, imported .css files, <style module>, and v-bind() in CSS all work on Lynx. <style scoped> is not yet supported — vote on #78 if you need it.
Feature support details
v-bind() in <style> requires one config option so the Lynx engine recognizes CSS custom properties in inline styles:
v-model
Vue's v-model creates two-way bindings. On components, the child uses defineModel() (Vue 3.4+) to declare a model prop, and the parent binds it with v-model. On native <input> and <textarea> elements, v-model works just like standard Vue, including the .lazy, .trim, and .number modifiers.
The example demonstrates:
- Default model —
defineModel<number>()withv-model="count"for a counter - Named models —
defineModel('title')+defineModel('body')withv-model:title/v-model:body - Native input v-model —
v-modeldirectly on<input>
v-model on <select>, <input type="checkbox">, and <input type="radio"> is not supported — Lynx has no native equivalents for these elements. Use component-level v-model with custom components instead.
Slots
Vue slots are the primary composition mechanism for passing template content into child components. Vue Lynx supports default slots, named slots, and scoped slots.
The example below demonstrates all three patterns:
- Default slot — content projected into a
<Card>component - Named slots —
#headerand#footerwith fallback content - Scoped slot — a
<DataList>exposes each item to the parent for custom rendering
Provide / Inject
Vue's provide and inject APIs let an ancestor component serve as a dependency injector for all its descendants, regardless of how deep the component hierarchy is. This avoids prop drilling through intermediate components.
The example below provides a reactive theme ref and a static appName string at the root. A grandchild component injects both — the middle layer passes nothing down.
Suspense
Vue's <Suspense> displays fallback content while waiting for async components to resolve. On Lynx, <Suspense> works with both async setup() (top-level await in <script setup>) and defineAsyncComponent for lazy-loading.
Transition
Vue's <Transition> and <TransitionGroup> components apply enter/leave animations when elements are inserted or removed.
<Transition> and <TransitionGroup> are experimental. Always pass an explicit :duration prop — getComputedStyle() is unavailable from the background thread. Move (FLIP) animations in <TransitionGroup> are not supported since getBoundingClientRect() is unavailable.
Options API
Vue 3 ships the Options API alongside the Composition API for backward compatibility.
By default, Vue Lynx enables it (optionsApi: true in the plugin), but you can disable it to reduce bundle size:
The example below uses defineComponent with data(), computed, watch, methods, and the mounted lifecycle hook:
Unsupported Features
Some Vue built-in features are not yet adapted to the dual-thread native environment: