Inset sheets
Five inset panels that float off the right edge with a margin and rounded corners: floating, rounded, margin, card and pill. Each is self-contained (no radix), sized, token-driven, and closes on backdrop click or Escape.
Installation
The styled layer is free and installs like any other ai2 component.
Run the following command
npx shadcn@latest add @ai2/sheet-insetDependencies, the @ai2/tokens theme and the component file are installed together.
Install dependencies
npm install motion lucide-reactCopy the source
components/ui/sheet-inset.tsx"use client"
import * as React from "react"
import { motion, AnimatePresence, useReducedMotion } from "motion/react"
import { X } from "lucide-react"
import { cn } from "@/lib/utils"
/* Inset sheet family: 5 decorative FLOATING side panels. They are not flush with
the edge; they sit inset from the right edge with a margin and all their corners
are rounded. Self-contained - no radix, no portal. A fixed inset-0 backdrop + a
fixed panel positioned inset from the right (z-50) sliding in from the right.
Internal state (defaultOpen) or controlled (open + onOpenChange). A backdrop
click / Escape / the close button closes it. The panel takes focus on open. The
slide runs through AnimatePresence; a fade under reduced-motion. Color comes ONLY
from tokens, with transparency via color-mix. */
export type StyledSize = "sm" | "md" | "lg" | "xl"
type Edge = "right" | "left" | "top" | "bottom"
const widthSize: Record<StyledSize, string> = {
sm: "w-72",
md: "w-80",
lg: "w-96",
xl: "w-[32rem]",
}
/* Vertical margin for the inset (setting top and bottom stretches the panel height automatically; this is used instead of h-full). Because this family slides in from the right, the right value is given per variant in panelClassName. */
const edgeAnchor: Record<Edge, string> = {
right: "inset-y-0 right-0",
left: "inset-y-0 left-0",
top: "inset-x-0 top-0",
bottom: "inset-x-0 bottom-0",
}
/* In Inset the panel sits with a margin, so a 100% translation leaves a sliver the size of that margin; an extra 2rem is added to clear the gap completely. */
function slideOffset(edge: Edge) {
switch (edge) {
case "right":
return { x: "calc(100% + 2rem)" }
case "left":
return { x: "calc(-100% - 2rem)" }
case "top":
return { y: "calc(-100% - 2rem)" }
case "bottom":
return { y: "calc(100% + 2rem)" }
}
}
interface SheetProps {
size?: StyledSize
trigger?: React.ReactNode
title?: React.ReactNode
children?: React.ReactNode
className?: string
open?: boolean
defaultOpen?: boolean
onOpenChange?: (o: boolean) => void
}
function useControllableOpen(
open: boolean | undefined,
defaultOpen: boolean | undefined,
onOpenChange: ((o: boolean) => void) | undefined
) {
const [uncontrolled, setUncontrolled] = React.useState(defaultOpen ?? false)
const isControlled = open !== undefined
const value = isControlled ? open : uncontrolled
const setValue = React.useCallback(
(next: boolean) => {
if (!isControlled) setUncontrolled(next)
onOpenChange?.(next)
},
[isControlled, onOpenChange]
)
return [value, setValue] as const
}
interface ShellProps extends SheetProps {
edge: Edge
slot: string
/* Inset konumu + koseler (or. "inset-y-4 right-4 rounded-xl"). */
anchorClassName: string
panelClassName: string
backdropClassName: string
}
function SheetShell({
edge,
slot,
anchorClassName,
panelClassName,
backdropClassName,
size = "md",
trigger,
title,
children,
className,
open,
defaultOpen,
onOpenChange,
}: ShellProps) {
const reduce = useReducedMotion()
const [isOpen, setOpen] = useControllableOpen(open, defaultOpen, onOpenChange)
const panelRef = React.useRef<HTMLDivElement>(null)
React.useEffect(() => {
if (!isOpen) return
const onKey = (e: KeyboardEvent) => {
if (e.key === "Escape") setOpen(false)
}
window.addEventListener("keydown", onKey)
return () => window.removeEventListener("keydown", onKey)
}, [isOpen, setOpen])
/* Inset panel: NO h-full; the height comes from the anchor's inset-y. The width is read from size only. */
const enter = slideOffset(edge)
return (
<div data-slot={slot} className="inline-flex">
{/* The ARIA state lives on the REAL trigger. There used to be a
`<span role="button" tabIndex={-1}>` wrapper, which produced two
buttons in the AX tree: one carrying the state (not focusable) and
one that took focus (stateless). A screen-reader user never heard
"has dialog" or "expanded" - measured with the CDP AX tree. */}
{React.isValidElement<React.ButtonHTMLAttributes<HTMLButtonElement>>(trigger) ? (
React.cloneElement(trigger, {
"aria-haspopup": "dialog",
"aria-expanded": isOpen,
onClick: (event: React.MouseEvent<HTMLButtonElement>) => {
trigger.props.onClick?.(event)
setOpen(true)
},
})
) : (
<button
type="button"
aria-haspopup="dialog"
aria-expanded={isOpen}
onClick={() => setOpen(true)}
className="inline-flex h-9 shrink-0 select-none items-center justify-center gap-2 rounded-lg border border-border bg-secondary px-4 text-sm font-medium text-secondary-foreground outline-none whitespace-nowrap transition-[color,background-color] duration-(--motion-fast) ease-(--motion-ease) hover:bg-surface-3 focus-visible:ring-[3px] focus-visible:ring-ring/50 [&_i]:text-base [&_i]:leading-none [&_svg]:pointer-events-none [&_svg]:size-4 [&_svg]:shrink-0"
>
{trigger ?? "Open"}
</button>
)}
<AnimatePresence>
{isOpen ? (
<div className="fixed inset-0 z-50">
<motion.div
data-slot="styled-sheet-backdrop"
onClick={() => setOpen(false)}
initial={{ opacity: 0 }}
animate={{ opacity: 1 }}
exit={{ opacity: 0 }}
transition={{ duration: reduce ? 0 : 0.2, ease: [0.4, 0, 0.2, 1] }}
className={cn("absolute inset-0", backdropClassName)}
/>
<motion.div
ref={panelRef}
data-slot="styled-sheet-panel"
role="dialog"
aria-modal="true"
tabIndex={-1}
onAnimationComplete={() => panelRef.current?.focus()}
initial={reduce ? { opacity: 0 } : enter}
animate={reduce ? { opacity: 1 } : { x: 0, y: 0 }}
exit={reduce ? { opacity: 0 } : enter}
transition={
reduce
? { duration: 0 }
: { type: "spring", stiffness: 320, damping: 34 }
}
className={cn(
"fixed flex flex-col gap-4 p-6 outline-none",
anchorClassName,
widthSize[size],
panelClassName,
className
)}
>
<div className="flex items-start justify-between gap-4">
{title ? (
<h2 data-slot="styled-sheet-title" className="text-base font-semibold text-foreground">
{title}
</h2>
) : (
<span />
)}
<button
type="button"
onClick={() => setOpen(false)}
aria-label="Close"
className="relative -m-1 inline-flex size-7 shrink-0 items-center justify-center rounded-md text-muted-foreground outline-none transition-[color,background-color] duration-(--motion-fast) ease-(--motion-ease) hover:bg-surface-3 hover:text-foreground focus-visible:ring-[3px] focus-visible:ring-ring/50 after:absolute after:-inset-2 [&_i]:text-base [&_i]:leading-none [&_svg]:size-4"
>
<X />
</button>
</div>
<div className="min-h-0 flex-1 overflow-auto text-sm text-muted-foreground">{children}</div>
</motion.div>
</div>
) : null}
</AnimatePresence>
</div>
)
}
const solidBackdrop = "bg-[color-mix(in_oklab,var(--color-foreground)_50%,transparent)]"
/* Floating: kenardan m-4 boslukla yuzen panel, tum koseler rounded-xl. */
export function FloatingSheet(props: SheetProps) {
return (
<SheetShell
{...props}
edge="right"
slot="styled-sheet"
backdropClassName={solidBackdrop}
anchorClassName="inset-y-4 right-4 rounded-xl"
panelClassName="border border-border bg-card text-card-foreground shadow-lg"
/>
)
}
/* Rounded: guclu rounded-2xl + belirgin golge. */
export function RoundedSheet(props: SheetProps) {
return (
<SheetShell
{...props}
edge="right"
slot="styled-sheet"
backdropClassName={solidBackdrop}
anchorClassName="inset-y-4 right-4 rounded-2xl"
panelClassName="border border-border bg-card text-card-foreground shadow-xl"
/>
)
}
/* Margin: daha genis kenar boslugu, kart hissi. */
export function MarginSheet(props: SheetProps) {
return (
<SheetShell
{...props}
edge="right"
slot="styled-sheet"
backdropClassName={solidBackdrop}
anchorClassName="inset-y-8 right-8 rounded-xl"
panelClassName="border border-border bg-card text-card-foreground shadow-lg"
/>
)
}
/* Card: belirgin border + golge ile net kart gorunumu. */
export function CardSheet(props: SheetProps) {
return (
<SheetShell
{...props}
edge="right"
slot="styled-sheet"
backdropClassName={solidBackdrop}
anchorClassName="inset-y-6 right-6 rounded-xl"
panelClassName="border-2 border-border bg-card text-card-foreground shadow-2xl"
/>
)
}
/* Pill: asiri yuvarlak koseler, hap benzeri form. */
export function PillSheet(props: SheetProps) {
return (
<SheetShell
{...props}
edge="right"
slot="styled-sheet"
backdropClassName={solidBackdrop}
anchorClassName="inset-y-6 right-6 rounded-[2.5rem]"
panelClassName="border border-border bg-card text-card-foreground shadow-xl"
/>
)
}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.
Floating
Floats off the right edge with an m-4 gap and rounded-xl corners.
import { FloatingSheet } from "@/components/ui/sheet-inset"
<FloatingSheet title="Sheet title">A floating side panel inset from the edge. Click the backdrop or press Escape to close.</FloatingSheet>Rounded
Strong rounded-2xl corners with a pronounced shadow.
import { RoundedSheet } from "@/components/ui/sheet-inset"
<RoundedSheet title="Sheet title">A floating side panel inset from the edge. Click the backdrop or press Escape to close.</RoundedSheet>Margin
Wider margin for a detached card feel.
import { MarginSheet } from "@/components/ui/sheet-inset"
<MarginSheet title="Sheet title">A floating side panel inset from the edge. Click the backdrop or press Escape to close.</MarginSheet>Card
A prominent border and shadow read as a floating card.
import { CardSheet } from "@/components/ui/sheet-inset"
<CardSheet title="Sheet title">A floating side panel inset from the edge. Click the backdrop or press Escape to close.</CardSheet>Pill
Extra-round, pill-like corners on a floating panel.
import { PillSheet } from "@/components/ui/sheet-inset"
<PillSheet title="Sheet title">A floating side panel inset from the edge. Click the backdrop or press Escape to close.</PillSheet>ai2 Inset sheets: 5 styled variations on the token system
The ai2 Inset sheets are a set of 5 decorative button variations from the styled layer of the @ai2 design system, built around inset, floating side panels detached from the edge. 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 slides the floating panel in from the right; the backdrop fades. The styled layer is opt-in, so the dependency only lands if you use it; the base components stay lean. Under reduced motion, the slide is skipped and the panel fades or shows instantly.
What is in the ai2 Inset sheets?
5 exports in one file: Floating, Rounded, Margin, Card and Pill. 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 slides the floating panel in from the right; the backdrop fades.
- Reduced-motion aware: Under prefers-reduced-motion, the slide is skipped and the panel fades or shows instantly.
- 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 Inset sheets 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.