Documentation

Documentation

Welcome

What DS-GN ships today — the public component and token packages.

DS-GN publishes two packages you can install today: a library of framework-agnostic web components, and the design tokens they are built on.

What’s available

Package What it is
@ds-gn/ui 24 web components as custom elements, with generated React wrappers.
@ds-gn/tokens The color, typography, spacing, radius, and shadow tokens they consume.

Both come from public npm. Neither needs an account, a token, or a custom .npmrc.

bun add @ds-gn/ui @ds-gn/tokens

The components are custom elements, so they work in plain HTML, React, Vue, Svelte, or anything else that can render a tag. React wrappers ship in the box; other frameworks consume the elements directly.

Start here

  • Installation — install the packages and wire up the token stylesheets.
  • Quick Start — build a working page with components, in HTML and in React.
  • Configuration — theming, dark mode, and the icon registry.
  • Content ownership — keep authored copy, accessible labels, and destinations in your application’s content source and pass them to components.
  • Public Beta support — the fixed component set and what the 0.x compatibility promise covers.

Reference

  • Components — every component’s props, slots, events, and accessibility notes.
  • Tokens — the token contract and how to rebrand by overriding it.

Coming soon

Coming soon. The @ds-gn-cli/create CLI — which scaffolds a whole design system from a canonical core plus language, styling, and tooling adapters — is not released yet. Create — Coming soon covers the planned capabilities. Nothing on this page depends on it.

Esc