About
What vd3 UI is, and the ideas behind it
vd3 UI
A Vue 3 design system and component library
What it is
vd3 UI is the standalone Vue 3 design system and component library of Vanduo. It ships everything in a single package — design tokens, a full CSS layer, and typed <Vd*> components with matching useX composables. Its only dependency is Vue itself.
You install one package, register a plugin, import the stylesheet, and start using components. There is no separate state library, no build-time runtime, and no global setup to wire up first.
How it's built
- One package, one dependency.
@vanduo-oss/vd3needs only Vue 3 (>= 3.3) — no Pinia and no extra runtime. - One source of truth for design. Colour, spacing, radius, and type all come from a single set of tokens, so the look stays consistent across every component. The scales are based on Fibonacci / golden-ratio proportions.
- Theming is built in. A few
data-*attributes switch palette, primary colour, radius, font, and light or dark mode, and the choice persists between visits. - Works with server-side rendering. Browser access is guarded throughout, so components render cleanly under SSR — the site you're reading is built that way.
What you get
- More than 50
<Vd*>components — forms, data display, navigation, feedback, layout primitives, and theme controls. - Around 35 composables for things like dropdowns, toasts, validation, scrolling, and drag-and-drop.
- A separate
@vanduo-oss/vd3-cbunbundle adding charts, a flowchart editor, hex grids, and a music player.
Open source
vd3 is MIT-licensed and free to use. The source is public on GitHub, and these docs are themselves built with the real components.