crucıble

Bellows

A dock whose icons magnify under the cursor with wave falloff to neighbors on spring physics — the swelling icon brightens with a soft white glow, neighbors catch a dimmer silver spill, and a soft reflection tracks the cursor across the plate. Keyboard focus magnifies like hover; coarse pointers get plain tap targets.

motionpro

Installation

CLI

npx shadcn@latest add @crucible/bellows

Manual — install dependencies, then copy the source

npm install motion

Props

PropTypeDefaultDescription
itemsBellowsItem[]a small generic setDock items.
sizenumber44Resting cell size in px.
magnificationnumber1.9Peak scale multiplier for the cell directly under the cursor.
distancenumber140Pixel radius of the magnify wave — how far the swell spills into neighbors.
spring{ stiffness?: number; damping?: number; mass?: number }Spring physics for cell growth.
heatnumber0.850–1: scales glow strength and the plate reflection together.
colors[string, string][spill, peak] — the dim neighbor-spill color and the bright peak color.
Also accepts all props of React.ComponentPropsWithoutRef<"nav">they pass through to the underlying element.

Honors prefers-reduced-motion with a designed static fallback, and passes className through.