Introduction

Vy UI is a two-layer component system for Vue-Lynx, the Vue bindings for Lynx, ByteDance's open-source native cross-platform framework. It brings Radix-style headless primitives, plus an optional opinionated styled kit, to a runtime that doesn't render HTML.

Status

Vy UI is alpha. In practice that has meant a steady component surface with churn underneath it: component names, props, and slots have held across @vyui/kit 0.3.x and @vyui/core 0.2.x, and the breaking changes so far removed unused exports rather than reshaping APIs.

The moving part is the layer below. Vue-Lynx labels itself pre-alpha, so build and runtime breakage can still reach you from upstream on a minor bump. Pin your versions, read the changelog before upgrading, and treat shipping to production as a judgement about Vue-Lynx's maturity as much as Vy UI's.

What's inside

• Native-first. Primitives target Lynx's <view> / <text> rendering model, not the DOM.
• Zero styling opinions. @vyui/core ships behavior and you bring the tokens, while @vyui/kit adds a themeable layer when you want one.
• Tailwind Variants. createTv() and tv() are re-exported from kit, so you can extend the theme the way you would with Nuxt UI or shadcn.

What each component page includes

1. An interactive browser preview for quickly exploring the component.
2. Copyable Vue-Lynx source using the actual package API.
3. Complete props, emits, slots, variants, and ui styling hooks.
4. Accessibility and native-platform notes.

The reference focuses on the public @vyui/kit surface. When a kit export directly exposes a @vyui/core primitive, the guide calls that out.