Glass accordions
Five frosted accordion treatments that vary the blur strength, translucency and tint: a balanced frost, a primary tint, a darker smoke, a crystal-clear panel and a layered depth. Each is self-contained, sized, token-driven and animates its height on open.
Installation
The styled layer is free and installs like any other ai2 component.
Run the following command
npx shadcn@latest add @ai2/accordion-glassDependencies, the @ai2/tokens theme and the component file are installed together.
Install dependencies
npm install motion lucide-reactCopy the source
components/ui/accordion-glass.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"
import { glassDepth } from "@/components/ui/glass"
/* Glass accordion family: 5 frosted-glass accordions. The glass surface is NO
LONGER hand-written: every variant derives from the glassDepth scale in
@ai2/glass, so it carries the ai2 inset-highlight signature. The variants
differ by depth step and tint.
Every export is a complete accordion: internal single-open state, a button
header with aria-expanded, framer height auto animation. Colour comes ONLY
from tokens. Alpha via color-mix. Under reduced-motion opening and closing
are instant. Size = padding + text scale. Renders without props too.
Depth map (large panels inside the page flow: medium weight):
Crystal -> sm (4px) clear glass; the name already says "clear", so little
blur is the honest choice
Frost -> md (8px) the canonical default frost
Tint -> md (8px) the SAME glass as Frost; the difference is the info
hue, not the blur
Smoke -> lg (16px) dense smoke; the content underneath becomes texture
Depth -> xl (24px) the only genuinely "floating" variant; this one earns
the xl
Glass does NOT stack: the outer container is not glass, the items are sibling
panels.
tailwind-merge trap: glassDepth carries a [box-shadow:...], which is why no
variant adds shadow-* / ring-* - doing so would silently drop the signature.
Extra definition is given through the border only. */
export type StyledSize = "sm" | "md" | "lg" | "xl"
export interface StyledAccordionItem {
value: string
title: React.ReactNode
content: React.ReactNode
}
interface StyledAccordionProps {
className?: string
size?: StyledSize
items?: StyledAccordionItem[]
defaultOpen?: string
}
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 defaultItems: StyledAccordionItem[] = [
{
value: "item-1",
title: "What is included?",
content:
"Every plan ships the full component library, semantic tokens, and lifetime updates for the tier you own.",
},
{
value: "item-2",
title: "How does installation work?",
content:
"Add any component with a single CLI command. Files land in your project and stay fully editable.",
},
{
value: "item-3",
title: "Can I use it in production?",
content:
"Yes. The system is framework agnostic, self contained, and safe to ship to any number of projects.",
},
]
function useSingleOpen(defaultOpen?: string) {
const [open, setOpen] = React.useState<string | null>(defaultOpen ?? null)
const toggle = React.useCallback(
(value: string) => setOpen((cur) => (cur === value ? null : value)),
[]
)
return { open, toggle }
}
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"
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>
)
}
function Chevron({ isOpen, size }: { isOpen: boolean; size: StyledSize }) {
const reduce = useReducedMotion()
return (
<motion.span
aria-hidden
className="shrink-0 text-muted-foreground"
animate={{ rotate: isOpen ? 180 : 0 }}
transition={reduce ? { duration: 0 } : { duration: 0.2 }}
>
<ChevronDown className={iconSize[size]} />
</motion.span>
)
}
/* Shared frosted-glass shell: every item is a separate translucent panel with
space between them. panelClass carries each variant's blur/tint technique. */
function GlassShell({
props,
panelClass,
}: {
props: StyledAccordionProps
panelClass: string
}) {
const { className, size = "md", items = defaultItems, defaultOpen } = props
const { open, toggle } = useSingleOpen(defaultOpen)
return (
<div
data-slot="styled-accordion"
className={cn("flex flex-col gap-2", className)}
>
{items.map((item) => {
const isOpen = open === item.value
return (
<div
key={item.value}
className={cn("overflow-hidden rounded-xl border", panelClass)}
>
<button
type="button"
aria-expanded={isOpen}
onClick={() => toggle(item.value)}
className={cn(headerBase, headerPad[size])}
>
{item.title}
<Chevron isOpen={isOpen} size={size} />
</button>
<Panel isOpen={isOpen} size={size}>
{item.content}
</Panel>
</div>
)
})}
</div>
)
}
/* Frost: the canonical default glass (md/8px). The scale's own bg-background/60
provides the surface; the variant only softens the border. */
export function FrostAccordion(props: StyledAccordionProps) {
return (
<GlassShell
props={props}
panelClass={cn(
glassDepth.md,
"border-[color-mix(in_oklab,var(--color-border)_60%,transparent)]"
)}
/>
)
}
/* Tint: the SAME md step as Frost - the difference is the info hue, not the
blur. (primary/brand chroma carries ~0.005, so a "primary tint" would be
invisible; the tint comes from info.) The tint bg-* replaces the scale's
bg-background/60, and the supports-[] variant has to be overridden too,
otherwise the neutral ground inside @supports suppresses the tint. */
export function TintAccordion(props: StyledAccordionProps) {
return (
<GlassShell
props={props}
panelClass={cn(
glassDepth.md,
"border-[color-mix(in_oklab,var(--color-info)_25%,transparent)]",
"bg-[color-mix(in_oklab,var(--color-info)_12%,transparent)]",
"supports-[backdrop-filter]:bg-[color-mix(in_oklab,var(--color-info)_12%,transparent)]"
)}
/>
)
}
/* Smoke: lg (16px) - turning the content underneath into texture is exactly
what Smoke promises. */
export function SmokeAccordion(props: StyledAccordionProps) {
return (
<GlassShell
props={props}
panelClass={cn(
glassDepth.lg,
"border-[color-mix(in_oklab,var(--color-foreground)_14%,transparent)]",
"bg-[color-mix(in_oklab,var(--color-foreground)_8%,transparent)]",
"supports-[backdrop-filter]:bg-[color-mix(in_oklab,var(--color-foreground)_8%,transparent)]"
)}
/>
)
}
/* Crystal: sm (4px). It used to be blur-xl, which contradicted its own name -
clear glass means little diffusion. The sm step's bg-background/50 is already
more transparent than Frost, so no extra tint is needed; the thin border
carries the character. */
export function CrystalAccordion(props: StyledAccordionProps) {
return (
<GlassShell
props={props}
panelClass={cn(
glassDepth.sm,
"border-[color-mix(in_oklab,var(--color-foreground)_10%,transparent)]"
)}
/>
)
}
/* Depth: xl (24px) - the one variant in the family meant to read as a genuinely
floating panel. The old shadow-sm was REMOVED: cn() collapses the same
box-shadow group down to the last one, so shadow-sm was silently erasing the
glassDepth signature. The extra definition now comes from an opaque
border-border. */
export function DepthAccordion(props: StyledAccordionProps) {
return (
<GlassShell
props={props}
panelClass={cn(
glassDepth.xl,
"border-border",
"bg-[color-mix(in_oklab,var(--color-surface-2)_65%,transparent)]",
"supports-[backdrop-filter]:bg-[color-mix(in_oklab,var(--color-surface-2)_65%,transparent)]"
)}
/>
)
}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.
Frost
A balanced frosted panel with a medium blur and a translucent popover surface.
import { FrostAccordion } from "@/components/ui/accordion-glass"
<FrostAccordion />Tint
A primary-tinted frosted panel with a medium blur.
import { TintAccordion } from "@/components/ui/accordion-glass"
<TintAccordion />Smoke
A darker smoked panel with a stronger blur.
import { SmokeAccordion } from "@/components/ui/accordion-glass"
<SmokeAccordion />Crystal
A very translucent panel with a strong blur-xl and a thin edge.
import { CrystalAccordion } from "@/components/ui/accordion-glass"
<CrystalAccordion />Depth
A layered surface with a defined edge, soft shadow and blur.
import { DepthAccordion } from "@/components/ui/accordion-glass"
<DepthAccordion />ai2 Glass accordions: 5 styled variations on the token system
The ai2 Glass accordions are a set of 5 decorative button variations from the styled layer of the @ai2 design system, built around frosted translucent collapsible sections with a blurred backdrop. 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 animates the panel height and rotates the icon on open. The styled layer is opt-in, so the dependency only lands if you use it; the base components stay lean. Under reduced motion, the panels expand and collapse instantly with no height animation.
What is in the ai2 Glass accordions?
5 exports in one file: Frost, Tint, Smoke, Crystal and Depth. 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 animates the panel height and rotates the icon on open.
- Reduced-motion aware: Under prefers-reduced-motion, the panels expand and collapse instantly with no height animation.
- 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 Glass accordions 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.