Default
Four doodles, six redraws a second. The shapes hold still; the lines shiver. Stops when the tab is hidden, off screen, and with reduced motion.
Makes drawn things shiver the way hand-animated line drawings do. About six times a second it moves to the next of a few frames: doodles are redrawn by a new hand, and buttons, cards and fields inside wobble a little differently. It stands still when motion is reduced, off screen and in a hidden tab.
npx shadcn@latest add @wobko/boilFirst time here? Add the registry to components.json first. How to install
Four doodles, six redraws a second. The shapes hold still; the lines shiver. Stops when the tab is hidden, off screen, and with reduced motion.
fps and strength tune the shiver. Drawn controls inside a Boil feel it too (through the ink knobs), so a call to action can be alive without any doodle.
A real use: the mascot in a card's corner and the underline of its heading boil, the text does not. Your own drawings join in with useBoilFrame or useBoilSeed.
A wrapper (an inline-block span). Direct children that take a `seed` (Doodle, Sticker, Mascot, Icon, Tape, Button…) get a new seed each frame; every drawn thing anywhere inside feels the frame through the ink context (wobble, fill offset, bleed and pen width move a few percent). Frames repeat, so after one turn every drawing comes from the cache: the cost is DOM updates, not drawing.
| Prop | Type | Default | Description |
|---|---|---|---|
| fps | number | 6 | Redraws per second, 1 to 12. |
| frames | number | 3 | How many different drawings it cycles through, 2 to 4. |
| strength | number | 1 | How far each frame is from the resting drawing: 0 none, 2 restless. |
| active | boolean | true | Turn it off without unmounting (frame 0, the resting drawing). |
| reseed | boolean | true | Give direct children a new seed each frame. Off: only the knobs move. |
| children | ReactNode | ({ frame, seed }) => ReactNode | - | A render prop gets the frame (0 to frames − 1) and `seed(base)`, for anything of your own that draws. |
The files the CLI copies into your project.
Loading the source