Components

Mascot

Stubby, the pencil stub who does the drawing. He waves in welcomes, thinks in empty search results, sleeps when nothing is happening. An original character drawn as a die-cut sticker: a chubby pencil stub with a face and nothing else (no arms, no legs, no clothes). His mood is his face, a small lean of the body and one doodle floating beside him.

Install

terminal
npx shadcn@latest add @wobko/mascot

First time here? Add the registry to components.json first. How to install

Examples

Poses

Stubby, an original pencil stub drawn as a die-cut sticker: one bold body with a face and nothing else. A pose is a different face, a lean and a doodle.

Sizes are redrawn

Under 28 px he is a face on a silhouette (two dots and a smile), 32 and 48 px add the blush, the wood and the graphite tip, 96 px is the master, 160 px adds a shine and a ferrule line.

An empty state

Where Stubby earns his keep: an empty search, a quiet inbox. The words carry the meaning, so he stays decorative.

API reference

Mascot

An intrinsic ink svg, one sticker body and a pose per state: white die-cut border and a soft shadow included, so `size` is the height of the whole sticker. Redrawn per size: under 28 px a face on a silhouette, under 56 the small redraw, then the master, and from 140 px a shine and a ferrule line. Weight of the svg (idle; the busiest pose is up to 1.6 times that): about 5 KB and 25 DOM nodes at 24 px, 12 KB and 27 nodes at 96, 18 KB and 30 nodes at 160 (every size is drawn with the engine's light `lo` tier; `tier="hi"` is about 2 times that). Several big Stubbys on one busy page are cheaper drawn at 120 px and enlarged with CSS (`h-auto w-52`): the line just gets bolder.

PropTypeDefaultDescription
poseMascotPose | string"idle"`idle`, `wave`, `think`, `write`, `sketch`, `celebrate`, `oops`, `shrug`, `sleep`, `peek`, `point`, `carry`, `halt`, `search`, `unplug`. An unknown name draws nothing.
sizenumber96Pixels tall, white die-cut border included (16 and up). Under 28 a face on a silhouette, under 56 the small redraw, up to 139 the master, from 140 the hero (a shine and a ferrule line).
seedstring | number-Another seed, another hand.
labelstring-Accessible name. Decorative (`aria-hidden`) without it.
framenumber-One drawing of a pose that is a flip book: `write` 1-3 (the lean deepens, the scribble grows), `wave` 1-3 (he rocks, the swishes move), `celebrate` 1-2 (up, and down again). Stack the frames and switch their opacity with `steps()` to animate him. A pose or number without that frame draws the still pose.
tier"lo" | "hi""lo"The engine's drawing quality. `hi` is a finer felt edge for a poster-sized Stubby, at about 2 times the markup; you cannot see it at 160 px.
shadowbooleantrueThe soft sticker shadow (the `ll-drop-sticker` class, a CSS filter). Turn it off where he sits on something that already casts one.

Accessibility

  • Decorative by default; the surrounding text ("Nothing here yet") is what carries meaning.

Source

The files the CLI copies into your project.

Loading the source