Using components

The provider, seeds, density and motion.

Wobko components take the same props as their shadcn/ui counterparts. If you know Button, Dialog or Tabs from shadcn/ui, you already know these. Each component page lists its parts and props.

This page covers what is different.

The drawing is a layer, not the component

A Wobko component renders its real DOM first: a <button>, an <input>, a Radix dialog. The drawing is one SVG behind that content. It is hidden from assistive technology and cannot take focus or clicks.

So a border or radius class on a component does not change the drawing. Use the props the component gives you, such as variant and size.

Seeds

Every drawing comes from a seed, so the same component keeps the same wobble from one render to the next. By default the seed comes from React's useId. Pass seed to pin a shape:

tsx
<Button seed="save-button">Save changes</Button>

Two components with the same seed and the same size draw the same lines. Give each one its own seed when a row of identical shapes looks too regular.

Density

There are three densities. comfortable is the default, compact is one step tighter, and calm is the lightest: thinner lines and single-pass fills.

Set it for the whole app on the provider:

tsx
<InkProvider density="compact">{children}</InkProvider>

Or for one region with an attribute:

tsx
<section data-density="calm">
  <SettingsForm />
</section>

Motion

Some components draw themselves in or wobble on hover. They follow the visitor's reduced-motion setting. To turn motion off for everyone:

tsx
<InkProvider motion="reduced">{children}</InkProvider>

Paper and desk

Two surfaces carry most layouts. Desk is the green background things lie on. Paper is a sheet: it has stocks such as paper, card, kraft and the sticky-note colors, and it can carry tape or a torn edge.

tsx
import { Desk } from "@/components/ui/desk"
import { Paper } from "@/components/ui/paper"

export function Page() {
  return (
    <Desk>
      <Paper stock="paper" tape="top" className="mx-auto max-w-3xl p-10">
        <h1>Notes</h1>
      </Paper>
    </Desk>
  )
}

Text set on paper or on the desk meets WCAG AA contrast with the default colors.