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/vd3 needs 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-cbun bundle 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.