Dock
navigationFreeMITA toolbar of app icons that bounce when picked, with labels on hover and arrow-key navigation.
Adapted from Watermelon UI (MIT) and rewritten with keyboard support, labels and reduced motion.
npx shadcn@latest add https://mikkelmanniche.dk/lab/r/dock.jsonPreview
Live demo in the dark theme.
Code
Install
npx shadcn@latest add https://mikkelmanniche.dk/lab/r/dock.jsonWith the registry added (components.json)
npx shadcn@latest add @manniche/dockUsage
import { Package, Search, Settings, ShoppingBag, Store } from 'lucide-react'
import { useState } from 'react'
import { Dock } from '@/components/dock'
const items = [
{ id: 'shop', label: 'Shop', icon: <Store /> },
{ id: 'search', label: 'Search', icon: <Search /> },
{ id: 'bag', label: 'Bag', icon: <ShoppingBag /> },
{ id: 'orders', label: 'Orders', icon: <Package /> },
{ id: 'settings', label: 'Settings', icon: <Settings /> },
]
export default function DockDemo() {
const [open, setOpen] = useState<string | null>('shop')
return (
<div className="flex justify-center pt-10">
<Dock label="Shop apps" items={items} value={open} onValueChange={setOpen} />
</div>
)
}Source
// Based on Watermelon UI's “Dock” (MIT, © 2026 Watermelon Platform Contributors,
// github.com/WatermelonCorp/watermelon-platform). Rewritten as a real toolbar with labels, arrow keys and a controlled value.
import { MotionConfig, motion } from 'motion/react'
import { useRef, useState, type KeyboardEvent, type ReactNode } from 'react'
import { cn } from '@/lib/utils'
export type DockItem = { id: string; label: string; icon: ReactNode }
export type DockProps = {
/** The icons to show, each with an id, a label and an icon. */
items: DockItem[]
/** Id of the open item, which gets the dot; null when none is open. */
value: string | null
/** Called with the item id when an icon is picked. */
onValueChange: (id: string) => void
/** Accessible name for the toolbar. */
label?: string
/** Classes for the toolbar. */
className?: string
}
/** A row of app icons that lift on hover and bounce when picked. The open one gets a dot. */
export function Dock({ items, value, onValueChange, label = 'Dock', className }: DockProps) {
const [bounce, setBounce] = useState<{ id: string; n: number } | null>(null)
const refs = useRef<(HTMLButtonElement | null)[]>([])
const pick = (id: string) => {
onValueChange(id)
setBounce((b) => ({ id, n: (b?.n ?? 0) + 1 }))
}
// One tab stop for the whole dock; the arrow keys move between icons.
const keys = (e: KeyboardEvent, i: number) => {
const step = { ArrowRight: 1, ArrowLeft: -1 }[e.key]
const to = step ? (i + step + items.length) % items.length : e.key === 'Home' ? 0 : e.key === 'End' ? items.length - 1 : -1
if (to < 0) return
e.preventDefault()
refs.current[to]?.focus()
}
const focusable = Math.max(0, items.findIndex((it) => it.id === value))
return (
<MotionConfig reducedMotion="user">
<div
role="toolbar"
aria-label={label}
className={cn('inline-flex items-end gap-2 rounded-3xl border bg-card px-2.5 pt-2.5 pb-1.5 shadow-sm', className)}
>
{items.map((it, i) => {
const active = it.id === value
return (
<div key={it.id} className="group relative flex flex-col items-center">
<span aria-hidden className="pointer-events-none absolute -top-9 rounded-lg bg-foreground px-2 py-1 text-xs whitespace-nowrap text-background opacity-0 transition-opacity duration-150 motion-reduce:transition-none group-hover:opacity-100 group-has-focus-visible:opacity-100">
{it.label}
</span>
<motion.button
ref={(el) => {
refs.current[i] = el
}}
type="button"
aria-label={it.label}
aria-pressed={active}
tabIndex={i === focusable ? 0 : -1}
onClick={() => pick(it.id)}
onKeyDown={(e) => keys(e, i)}
whileHover={{ y: -4 }}
transition={{ type: 'spring', stiffness: 550, damping: 15, mass: 1.1 }}
className="rounded-xl"
>
{/* A new key replays the bounce without remounting the button, so focus stays put. */}
<motion.span
key={bounce?.id === it.id ? bounce.n : 0}
style={{ transformOrigin: 'bottom' }}
initial={bounce?.id === it.id ? { scale: 1.3, y: -8 } : false}
animate={{ scale: 1, y: 0 }}
transition={{ type: 'spring', stiffness: 550, damping: 15, mass: 1.1 }}
className={cn(
'grid size-11 place-items-center rounded-xl bg-muted transition-colors duration-200 motion-reduce:transition-none [&_svg]:size-5',
active ? 'text-foreground' : 'text-muted-foreground hover:text-foreground',
)}
>
{it.icon}
</motion.span>
</motion.button>
<span
aria-hidden
className={cn('mt-1 size-1 rounded-full bg-foreground/50 transition-opacity duration-300 motion-reduce:transition-none', active ? 'opacity-100' : 'opacity-0')}
/>
</div>
)
})}
</div>
</MotionConfig>
)
}Props
DockProps
| Prop | Type | Default | What it does |
|---|---|---|---|
items required | DockItem[] | – | The icons to show, each with an id, a label and an icon. |
value required | string | null | – | Id of the open item, which gets the dot; null when none is open. |
onValueChange required | (id: string) => void | – | Called with the item id when an icon is picked. |
label | string | 'Dock' | Accessible name for the toolbar. |
className | string | – | Classes for the toolbar. |
A11y
Keyboard
The dock has one Tab stop, on the open item (or the first item). ArrowRight and ArrowLeft wrap around, and Home and End jump to the ends. Enter or Space picks the item. The label shows as a tooltip on hover and on keyboard focus.
Screen reader
The dock is a toolbar named by label (default Dock). Each icon button is named by its label and sets aria-pressed for the open one. The tooltip text and the dot under the open item are aria-hidden, so the name is read once.
Reduced motion
The component is wrapped in MotionConfig with reducedMotion set to user, so Motion follows the system setting for the lift and bounce. The tooltip fade and colour transitions are off under reduced motion.