Accent collapsibles
Five collapsibles led by a primary left bar that grows or brightens as the panel opens: bar, grow, glow, left and full. Each toggles a token content panel with an accessible trigger and is sized.
Installation
The styled layer is free and installs like any other ai2 component.
Run the following command
npx shadcn@latest add @ai2/collapsible-accentDependencies, the @ai2/tokens theme and the component file are installed together.
Install dependencies
npm install motion lucide-reactCopy the source
components/ui/collapsible-accent.tsx"use client"
import * as React from "react"
import { ChevronDown } from "lucide-react"
import { AnimatePresence, motion, useReducedMotion } from "motion/react"
import { cn } from "@/lib/utils"
/* Accent collapsible family: 5 collapsibles with a primary left bar. Each export
is a complete collapsible: a single trigger + a single expanding body, a button
with aria-expanded, and a framer height auto animation. Works controlled
(open/onOpenChange) and uncontrolled (defaultOpen). The difference is on the
LEFT BAR: a primary line that grows or glows while open (Bar, Grow, Glow, Left,
Full). Color comes ONLY from tokens. Alpha via color-mix. No transform under
reduced-motion. Size = padding + text scale. */
export type StyledSize = "sm" | "md" | "lg" | "xl"
interface StyledCollapsibleProps {
className?: string
size?: StyledSize
title?: React.ReactNode
children?: React.ReactNode
open?: boolean
defaultOpen?: boolean
onOpenChange?: (o: boolean) => void
}
const headerPad: Record<StyledSize, string> = {
sm: "px-3 py-2.5 text-sm",
md: "px-4 py-3 text-sm",
lg: "px-5 py-4 text-base",
xl: "px-6 py-5 text-lg",
}
const bodyPad: Record<StyledSize, string> = {
sm: "px-3 pb-2.5 text-sm",
md: "px-4 pb-3 text-sm",
lg: "px-5 pb-4 text-base",
xl: "px-6 pb-5 text-base",
}
const iconSize: Record<StyledSize, string> = {
sm: "size-4",
md: "size-4",
lg: "size-5",
xl: "size-5",
}
const headerBase =
"flex w-full items-center justify-between gap-3 text-left font-medium outline-none transition-colors focus-visible:ring-[3px] focus-visible:ring-ring/50"
const defaultTitle = "What is included?"
const defaultChildren =
"Every plan ships the full component library, semantic tokens, and lifetime updates for the tier you own. Add any component with a single CLI command and keep the files fully editable."
/* Controlled and uncontrolled open state in a single hook. */
function useControllableOpen({
open,
defaultOpen,
onOpenChange,
}: {
open?: boolean
defaultOpen?: boolean
onOpenChange?: (o: boolean) => void
}) {
const isControlled = open !== undefined
const [internal, setInternal] = React.useState<boolean>(defaultOpen ?? false)
const current = isControlled ? (open as boolean) : internal
const toggle = React.useCallback(() => {
const next = !current
if (!isControlled) setInternal(next)
onOpenChange?.(next)
}, [current, isControlled, onOpenChange])
return { isOpen: current, toggle }
}
function Chevron({ isOpen, size }: { isOpen: boolean; size: StyledSize }) {
const reduce = useReducedMotion()
return (
<motion.span
aria-hidden
className="shrink-0 text-muted-foreground"
animate={reduce ? undefined : { rotate: isOpen ? 180 : 0 }}
transition={reduce ? { duration: 0 } : { type: "spring" as const, stiffness: 300, damping: 24 }}
>
<ChevronDown className={iconSize[size]} />
</motion.span>
)
}
function Panel({
isOpen,
size,
children,
}: {
isOpen: boolean
size: StyledSize
children: React.ReactNode
}) {
const reduce = useReducedMotion()
return (
<AnimatePresence initial={false}>
{isOpen && (
<motion.div
key="panel"
initial={reduce ? false : { height: 0, opacity: 0 }}
animate={{ height: "auto", opacity: 1 }}
exit={{ height: 0, opacity: 0 }}
transition={
reduce ? { duration: 0 } : { duration: 0.25, ease: [0.4, 0, 0.2, 1] }
}
className="overflow-hidden"
>
<div className={cn(bodyPad[size], "text-muted-foreground")}>{children}</div>
</motion.div>
)}
</AnimatePresence>
)
}
/* Shared shell: a primary bar on the left. When grow=true the bar grows from the top down while open (scaleY), otherwise it appears with opacity. glow adds a tinted shadow, and tintOpen gives a light primary surface while open. */
function AccentShell({
props,
barWidth,
grow,
glow,
tintOpen,
}: {
props: StyledCollapsibleProps
barWidth: string
grow?: boolean
glow?: boolean
tintOpen?: boolean
}) {
const { className, size = "md", title = defaultTitle, children = defaultChildren } = props
const { isOpen, toggle } = useControllableOpen(props)
const reduce = useReducedMotion()
return (
<div
data-slot="styled-collapsible"
className={cn(
"relative overflow-hidden rounded-xl border border-border bg-background transition-colors",
tintOpen && isOpen &&
"bg-[color-mix(in_oklab,var(--color-primary)_6%,transparent)]",
className
)}
>
<motion.span
aria-hidden
className={cn(
"absolute inset-y-0 left-0 origin-top rounded-r bg-primary",
barWidth,
glow && "shadow-[0_0_12px_color-mix(in_oklab,var(--color-primary)_60%,transparent)]"
)}
initial={false}
animate={
reduce
? undefined
: grow
? { scaleY: isOpen ? 1 : 0.35, opacity: isOpen ? 1 : 0.5 }
: { opacity: isOpen ? 1 : 0.4 }
}
transition={reduce ? { duration: 0 } : { type: "spring" as const, stiffness: 260, damping: 26 }}
/>
<button
type="button"
aria-expanded={isOpen}
onClick={toggle}
className={cn(
headerBase,
headerPad[size],
"pl-5 hover:bg-[color-mix(in_oklab,var(--color-foreground)_5%,transparent)]"
)}
>
{title}
<Chevron isOpen={isOpen} size={size} />
</button>
<div className="pl-2">
<Panel isOpen={isOpen} size={size}>
{children}
</Panel>
</div>
</div>
)
}
/* Bar: a thin primary line that becomes fully opaque when on. */
export function BarCollapsible(props: StyledCollapsibleProps) {
return <AccentShell props={props} barWidth="w-1" />
}
/* Grow: bar acikken tepeden asagi buyuyerek uzar. */
export function GrowCollapsible(props: StyledCollapsibleProps) {
return <AccentShell props={props} barWidth="w-1" grow />
}
/* Glow: buyuyen bar + primary tonlu yumusak parilti. */
export function GlowCollapsible(props: StyledCollapsibleProps) {
return <AccentShell props={props} barWidth="w-1" grow glow />
}
/* Left: a thick left bar, fully opaque when on (static height). */
export function LeftCollapsible(props: StyledCollapsibleProps) {
return <AccentShell props={props} barWidth="w-1.5" />
}
/* Full: buyuyen bar + acikken hafif primary yuzey tinti. */
export function FullCollapsible(props: StyledCollapsibleProps) {
return <AccentShell props={props} barWidth="w-1.5" grow tintOpen />
}Manual installs skip the @ai2/tokens theme, so add the token CSS from the theming guide or the tone colors will be missing.
Variations
5 takes on the same idea. Each is its own export, and every one accepts a size prop (sm, md, lg, xl) aligned to the base Button scale.
Bar
A thin primary bar that turns fully opaque when open.
import { BarCollapsible } from "@/components/ui/collapsible-accent"
<BarCollapsible />Grow
The bar scales from the top down as the panel opens.
import { GrowCollapsible } from "@/components/ui/collapsible-accent"
<GrowCollapsible />Glow
A growing bar with a soft primary-tinted glow.
import { GlowCollapsible } from "@/components/ui/collapsible-accent"
<GlowCollapsible />Left
A thicker static left bar that brightens when open.
import { LeftCollapsible } from "@/components/ui/collapsible-accent"
<LeftCollapsible />Full
A growing bar plus a faint primary surface tint when open.
import { FullCollapsible } from "@/components/ui/collapsible-accent"
<FullCollapsible />ai2 Accent collapsibles: 5 styled variations on the token system
The ai2 Accent collapsibles are a set of 5 decorative button variations from the styled layer of the @ai2 design system, built around disclosures led by an animated primary left bar. They are free and MIT licensed, and every color comes from a semantic token, so they theme with the rest of ai2 in light and dark.
Motion runs on framer-motion: framer-motion springs the left bar and animates the panel height. The styled layer is opt-in, so the dependency only lands if you use it; the base components stay lean. Under reduced motion, the bar and panel change state instantly with no transforms.
What is in the ai2 Accent collapsibles?
5 exports in one file: Bar, Grow, Glow, Left and Full. Each renders a native button and takes a size prop (sm, md, lg, xl) aligned to the base Button. They are separate from the base Button on purpose: the base keeps its clean variant, tone and size axes, while the styled layer carries the effects.
You own the file. Copy the one category file and you have all 5 variations, with no runtime dependency on ai2 itself.
Why use it
- On-system by construction: Every color resolves to an ai2 semantic token, so the buttons follow your theme in light and dark with no extra work.
- Effect without the sprawl: The decorations live in a dedicated styled file, so the base Button keeps its clean, predictable API.
- Accessible and honest: Each renders a real button element, keeps a visible focus ring, and respects prefers-reduced-motion.
Features
- Token-driven color: No hardcoded hex or oklch; the look recolors with your theme tokens.
- framer-motion: framer-motion springs the left bar and animates the panel height.
- Reduced-motion aware: Under prefers-reduced-motion, the bar and panel change state instantly with no transforms.
- Size aligned to the base: Every variation takes sm, md, lg and xl matching the base Button height scale, so styled and base buttons line up in a row.
Production tips
- Use it for emphasis, not everywhere: Styled buttons draw the eye. Reserve them for the one action you want people to take on a screen, and use the base Button for the rest.
- Keep labels as verbs: The decoration adds weight, so a clear action label keeps the button scannable.
- Pick one variation per surface: The variations share a family; using two different ones in the same view competes for attention.
Works with the rest of ai2
The Accent collapsibles sit alongside the base Button and the rest of the @ai2 registry. They share the same token file, so a styled action next to a base button or a badge stays visually consistent in both modes.