Expandable Tabs
Expandable Tabs: Icon tab bar where the active tab expands to a labelled pill, with a panel above that morphs height and slides content direction-aware on switch. Free MIT React & Next.js source with Motion and Tailwind CSS, live preview, CLI install and docs.
Install Expandable Tabs
npx motion-ui-skill add expandable-tabsComponents install as source into your project. The interactive page also includes preview, code, documentation and install tabs.
Dependencies
clsxmotionreacttailwind-merge
Source files
Expandable Tabs
Icon tab bar where the active tab expands to a labelled pill, with a panel above that morphs height and slides content direction-aware on switch.
Install
npx motion-ui-skill add expandable-tabs
Dependencies
clsxlucide-reactmotionreacttailwind-merge
Usage
"use client";
import {
BadgeCheck,
Brush,
CalendarClock,
ChartSpline,
ChevronRight,
ClipboardCheck,
CloudUpload,
FileText,
Gauge,
GitBranch,
Images,
Inbox,
type LucideIcon,
Megaphone,
MessageCircle,
PackageOpen,
RefreshCw,
Rocket,
Siren,
SwatchBook,
UploadCloud,
Users,
Webhook,
Workflow,
} from "lucide-react";
import { ExpandableTabs } from "@/components/motion/expandable-tabs";
function Row({ icon: Icon, label }: { icon: LucideIcon; label: string }) {
return (
<button
type="button"
className="flex w-full items-center gap-3 rounded-xl px-3 py-2.5 text-left text-sm font-medium text-foreground transition-colors hover:bg-muted"
>
<Icon className="h-4 w-4 text-muted-foreground" />
<span className="flex-1">{label}</span>
<ChevronRight className="h-4 w-4 text-muted-foreground" />
</button>
);
}
function Menu({ rows }: { rows: { icon: LucideIcon; label: string }[] }) {
return (
<div className="flex w-[17.125rem] flex-col gap-0.5">
{rows.map((r) => (
<Row key={r.label} icon={r.icon} label={r.label} />
))}
</div>
);
}
export function ExpandableTabsPreview() {
return (
<div className="flex min-h-88 w-full items-end justify-center">
<ExpandableTabs
items={[
{
id: "launch",
label: "Launch",
icon: <Rocket className="h-4 w-4" />,
content: (
<Menu
rows={[
{ icon: FileText, label: "Release Brief" },
{ icon: ClipboardCheck, label: "Launch Checklist" },
{ icon: Megaphone, label: "Campaign Notes" },
{ icon: CalendarClock, label: "Rollout Calendar" },
{ icon: CloudUpload, label: "Ship Build" },
]}
/>
),
},
{
id: "inbox",
label: "Inbox",
icon: <Inbox className="h-4 w-4" />,
content: (
<Menu
rows={[
{ icon: MessageCircle, label: "Client Feedback" },
{ icon: Users, label: "Team Requests" },
{ icon: BadgeCheck, label: "Approval Notes" },
]}
/>
),
},
{
id: "flows",
label: "Flows",
icon: <Workflow className="h-4 w-4" />,
content: (
<Menu
rows={[
{ icon: GitBranch, label: "Trigger Map" },
{ icon: Webhook, label: "Webhook Runs" },
{ icon: RefreshCw, label: "Retry Queue" },
]}
/>
),
},
{
id: "assets",
label: "Assets",
icon: <PackageOpen className="h-4 w-4" />,
content: (
<Menu
rows={[
{ icon: SwatchBook, label: "Brand Kit" },
{ icon: Images, label: "Mockup Library" },
{ icon: Brush, label: "Design Tokens" },
{ icon: UploadCloud, label: "Export Queue" },
]}
/>
),
},
{
id: "status",
label: "Status",
icon: <ChartSpline className="h-4 w-4" />,
content: (
<Menu
rows={[
{ icon: Gauge, label: "Activation" },
{ icon: ChartSpline, label: "Conversion" },
{ icon: Siren, label: "Incidents" },
]}
/>
),
},
]}
/>
</div>
);
}
API Reference
ExpandableTabs
| Prop | Type | Default | Required | Description |
|---|---|---|---|---|
items |
ExpandableTabsItem[] |
— | Yes | — |
value |
string | null |
— | No | Active tab id, or null/undefined for the closed (bar-only) state. |
defaultValue |
string | null |
null |
No | — |
onValueChange |
((id: string | null) => void) |
— | No | — |
className |
string |
— | No | — |
classNames |
ExpandableTabsClassNames |
— | No | — |