Shiny buttons
Five takes on light and reflection: a shimmer sweep, a looping sheen, a brushed-metal surface, a spotlight bloom and an iridescent holographic drift. Each is sized and token-driven.
Installation
The styled layer is free and installs like any other ai2 component.
Run the following command
npx shadcn@latest add @ai2/buttons-shinyDependencies, the @ai2/tokens theme and the component file are installed together.
Install dependencies
npm install motionCopy the source
components/ui/buttons-shiny.tsx"use client"
import type * as React from "react"
import { motion, useReducedMotion, type HTMLMotionProps } from "motion/react"
import { cn } from "@/lib/utils"
/* Shiny button family: 5 variations on light and reflection. All are sized (aligned with the base scale), use framer-motion (motion/react), take colour ONLY from semantic tokens and are reduced-motion safe. The sheens derive from primary-foreground so they are visible over the button in both themes (a plain white glare disappeared in dark). */
export type StyledSize = "sm" | "md" | "lg" | "xl"
const sizes: Record<StyledSize, string> = {
sm: "h-8 gap-1.5 rounded-md px-3 text-sm",
md: "h-9 gap-2 rounded-lg px-4 text-sm",
lg: "h-10 gap-2 rounded-lg px-5 text-sm",
xl: "h-12 gap-2.5 rounded-xl px-6 text-base",
}
const base =
"relative inline-flex shrink-0 select-none items-center justify-center overflow-hidden font-medium whitespace-nowrap outline-none focus-visible:ring-[3px] focus-visible:ring-ring/50 disabled:pointer-events-none disabled:opacity-50 [&_svg]:pointer-events-none [&_svg]:size-4 [&_svg]:shrink-0 [&_i]:text-base [&_i]:leading-none"
type Props = HTMLMotionProps<"button"> & { size?: StyledSize }
/* Shimmer: a single sweep of light passing over it on hover (foreground sheen). */
export function ShimmerButton({ className, size = "md", children, ...props }: Props) {
const reduce = useReducedMotion()
return (
<motion.button
data-slot="styled-button"
whileHover={reduce ? undefined : { scale: 1.03 }}
whileTap={reduce ? undefined : { scale: 0.97 }}
transition={{ type: "spring", stiffness: 400, damping: 20 }}
className={cn(base, sizes[size], "group bg-primary text-primary-foreground", className)}
{...props}
>
<span
aria-hidden="true"
className="pointer-events-none absolute inset-0 -translate-x-full bg-gradient-to-r from-transparent via-primary-foreground/25 to-transparent transition-transform duration-700 ease-out group-hover:translate-x-[130%] motion-reduce:hidden"
/>
<span className="relative flex items-center gap-2">{children as React.ReactNode}</span>
</motion.button>
)
}
/* Sheen: bekleme durumunda bile surekli tekrar eden capraz parlama dongusu. */
export function SheenButton({ className, size = "md", children, ...props }: Props) {
const reduce = useReducedMotion()
return (
<motion.button
data-slot="styled-button"
whileTap={reduce ? undefined : { scale: 0.97 }}
transition={{ type: "spring", stiffness: 400, damping: 20 }}
className={cn(base, sizes[size], "bg-primary text-primary-foreground", className)}
{...props}
>
<motion.span
aria-hidden="true"
className="pointer-events-none absolute inset-y-0 -left-1/2 w-1/3 -skew-x-12 bg-primary-foreground/20 blur-sm"
animate={reduce ? undefined : { left: ["-50%", "150%"] }}
transition={reduce ? undefined : { duration: 2.4, ease: "easeInOut", repeat: Infinity, repeatDelay: 1 }}
/>
<span className="relative flex items-center gap-2">{children as React.ReactNode}</span>
</motion.button>
)
}
/* Metallic: token yuzeyden turemis fircalanmis metal gradyani + hover parlamasi. */
export function MetallicButton({ className, size = "md", children, ...props }: Props) {
const reduce = useReducedMotion()
return (
<motion.button
data-slot="styled-button"
whileHover={reduce ? undefined : { scale: 1.03 }}
whileTap={reduce ? undefined : { scale: 0.97 }}
transition={{ type: "spring", stiffness: 400, damping: 20 }}
className={cn(
base,
sizes[size],
"group border border-border bg-gradient-to-b from-surface-3 via-surface-2 to-secondary text-foreground",
className
)}
{...props}
>
<span
aria-hidden="true"
className="pointer-events-none absolute inset-x-0 top-0 h-1/2 bg-gradient-to-b from-foreground/10 to-transparent"
/>
<span
aria-hidden="true"
className="pointer-events-none absolute inset-0 -translate-x-full bg-gradient-to-r from-transparent via-foreground/15 to-transparent transition-transform duration-700 ease-out group-hover:translate-x-[130%] motion-reduce:hidden"
/>
<span className="relative flex items-center gap-2">{children as React.ReactNode}</span>
</motion.button>
)
}
/* Spotlight: a soft light opening from the centre on hover (radial, token). */
export function SpotlightButton({ className, size = "md", children, ...props }: Props) {
const reduce = useReducedMotion()
return (
<motion.button
data-slot="styled-button"
whileHover={reduce ? undefined : { scale: 1.03 }}
whileTap={reduce ? undefined : { scale: 0.97 }}
transition={{ type: "spring", stiffness: 400, damping: 20 }}
className={cn(base, sizes[size], "group bg-primary text-primary-foreground", className)}
{...props}
>
<span
aria-hidden="true"
className="pointer-events-none absolute inset-0 scale-0 rounded-[inherit] bg-[radial-gradient(circle_at_center,color-mix(in_oklch,var(--color-primary-foreground)_35%,transparent),transparent_60%)] opacity-0 transition-all duration-(--motion-base) ease-(--motion-ease) group-hover:scale-100 group-hover:opacity-100"
/>
<span className="relative flex items-center gap-2">{children as React.ReactNode}</span>
</motion.button>
)
}
/* Holographic: cok tonlu (info/success/primary) yaniltici sheen surekli kayar. */
export function HolographicButton({ className, size = "md", children, ...props }: Props) {
const reduce = useReducedMotion()
return (
<motion.button
data-slot="styled-button"
whileHover={reduce ? undefined : { scale: 1.03 }}
whileTap={reduce ? undefined : { scale: 0.97 }}
transition={{ type: "spring", stiffness: 400, damping: 20 }}
className={cn(
base,
sizes[size],
"border border-border bg-secondary text-secondary-foreground",
className
)}
{...props}
>
<motion.span
aria-hidden="true"
className="pointer-events-none absolute inset-0 bg-[linear-gradient(110deg,transparent,color-mix(in_oklch,var(--color-info)_50%,transparent),color-mix(in_oklch,var(--color-success)_50%,transparent),color-mix(in_oklch,var(--color-primary)_50%,transparent),transparent)] bg-[length:250%_100%] opacity-70 mix-blend-overlay"
animate={reduce ? undefined : { backgroundPositionX: ["0%", "100%"] }}
transition={reduce ? undefined : { duration: 4, ease: "linear", repeat: Infinity }}
/>
<span className="relative flex items-center gap-2">{children as React.ReactNode}</span>
</motion.button>
)
}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.
Shimmer
A single band of light sweeps across on hover.
import { ShimmerButton } from "@/components/ui/buttons-shiny"
<ShimmerButton>Shimmer</ShimmerButton>Sheen
A diagonal glint loops across even at rest.
import { SheenButton } from "@/components/ui/buttons-shiny"
<SheenButton>Sheen</SheenButton>Metallic
A brushed-metal surface from surface tokens, with a hover glare.
import { MetallicButton } from "@/components/ui/buttons-shiny"
<MetallicButton>Metallic</MetallicButton>Spotlight
A soft light opens from the center on hover.
import { SpotlightButton } from "@/components/ui/buttons-shiny"
<SpotlightButton>Spotlight</SpotlightButton>Holographic
A multi-token iridescent sheen drifts continuously.
import { HolographicButton } from "@/components/ui/buttons-shiny"
<HolographicButton>Holographic</HolographicButton>ai2 Shiny buttons: 5 styled variations on the token system
The ai2 Shiny buttons are a set of 5 decorative button variations from the styled layer of the @ai2 design system, built around light and reflection. 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 powers the hover sweep, the looping sheen and the drifting holographic gradient. The styled layer is opt-in, so the dependency only lands if you use it; the base components stay lean. Under reduced motion, the sweeps and loops stop and the buttons stay still.
What is in the ai2 Shiny buttons?
5 exports in one file: Shimmer, Sheen, Metallic, Spotlight and Holographic. 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 powers the hover sweep, the looping sheen and the drifting holographic gradient.
- Reduced-motion aware: Under prefers-reduced-motion, the sweeps and loops stop and the buttons stay still.
- 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 Shiny buttons 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.