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:
<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:
<InkProvider density="compact">{children}</InkProvider>Or for one region with an attribute:
<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:
<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.
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.