Dynamic Island
Overview
An iOS-style island pill that morphs between live activity views with a bouncy resize.
This status component is intended for interfaces that need an iOS-style island pill that morphs between live activity views with a bouncy resize, dashboards, and operations tables. Its implementation is provided as editable source so the final behavior and styling stay inside your project.
Technologies
Detected package dependencies: motion, clsx, tailwind-merge.
Focus
24:59
Installation
Usage
import { DynamicIsland, DynamicIslandView } from "@/components/motion/dynamic-island"<DynamicIsland view={view} compact={<Dot />}>
<DynamicIslandView id="timer">…</DynamicIslandView>
<DynamicIslandView id="music">…</DynamicIslandView>
</DynamicIsland>API Reference
DynamicIsland
beUI's Dynamic Island block (beui.dev, MIT), installed from its shadcn registry into components/motion. The shell animates real width and height on a long spring with barely-there bounce, while views crossfade with blur. Set view to null for the compact pill.
| Prop | Type | Default | Description |
|---|---|---|---|
*view | string | null | - | Active view id; null shows the compact pill |
compact | ReactNode | - | Compact pill content shown when no view is active |
children | ReactNode | - | DynamicIslandView elements |
className | string | - | Classes for the shell |
DynamicIslandView
One view inside the island. Only the view whose id matches the parent's view prop is rendered.
| Prop | Type | Default | Description |
|---|---|---|---|
*id | string | - | Matches the parent view prop when active |
*children | ReactNode | - | View content |
className | string | - | Classes for the view |
Use cases
- interfaces that need an iOS-style island pill that morphs between live activity views with a bouncy resize
- dashboards
- operations tables
Features
- Copy-paste source that remains in your repository
- TypeScript source included with the component
- Tailwind CSS classes editable in the component source
- Animation implemented with Motion
- Reduced-motion handling present in the source
Accessibility
- The source includes ARIA attributes or roles; preserve them when customizing the component.
- The source checks reduced-motion preferences or includes motion-reduce styles.
- Test focus order, keyboard operation, labels, contrast, and screen-reader output in the final application context.
Customization
- Edit the Tailwind utility classes in the copied source to match your spacing, color, and typography tokens.
- Use the documented className surface for local layout adjustments, then edit the source for structural changes.
- Adjust Motion transitions in the source and keep the reduced-motion behavior aligned with the final interaction.
Related components
Dynamic Island FAQ
Is Dynamic Island free to use in commercial projects?
Yes. The public Dynamic Island source is available under the Apache License 2.0, including for commercial use, subject to the LICENSE terms.
How do I install Dynamic Island?
Run npx shadcn@latest add @spectrumui/dynamic-island. The page also exposes the source for manual installation.
Does Dynamic Island require Motion?
Yes. Motion usage was detected in the documented source or registry dependencies for Dynamic Island.
Does Dynamic Island use shadcn/ui or Radix UI?
No shadcn/ui or Radix UI dependency was detected in the documented Dynamic Island source.
Can I use Dynamic Island in Next.js?
The documented React source is used in this Next.js application. Keep its use client directive when copying it into the App Router. Install the detected dependencies and verify any application-specific data or image configuration.
What accessibility checks should I run for Dynamic Island?
The source includes ARIA markup, reduced-motion handling. Test the finished interface with keyboard and screen-reader workflows.