Components
Complete reference for every Aura UI component gallery, installation command, and usage pattern.
Aura UI components are available as interactive galleries under /components. Each gallery contains the live preview, variants, source code, and installation command for that component.
Component catalog
Inputs
| Component | What it includes | Gallery |
|---|---|---|
| Button | Animated, glass, gradient, clay, and action button variants | Open Buttons |
| Input | Text, search, leading-icon, trailing-icon, and focused input states | Open Inputs |
| Image Uploader | Upload, preview, crop, zoom, rotate, and confirm states | Open Image Uploader |
| Select | Basic, searchable, grouped, and multi-value dropdowns | Open Select |
| Checkbox | Ten animated checkbox and selection patterns | Open Checkboxes |
Display
| Component | What it includes | Gallery |
|---|---|---|
| Cards | Interactive surface and content card layouts | Open Cards |
| Badges | Status, notification, label, and animated badge variants | Open Badges |
| Loaders | Ten loading indicators for async and branded states | Open Loaders |
| Tables | Dense, responsive, and interactive data table patterns | Open Tables |
| Avatar Stack | Photo, initials, grouped, and animated avatar stacks | Open AvatarStack |
| Progress | Linear, circular, segmented, and animated progress states | Open Progress |
Navigation and overlays
| Component | What it includes | Gallery |
|---|---|---|
| Navbar | Apple, macOS, iOS glass, dashboard, and mega-menu navigation | Open Navbar |
| Toast | Feedback, action, progress, mobile, and animated notification states | Open Toast |
| Tooltip | Basic, rich, delayed, and smart-positioned tooltips | Open Tooltip |
| Footer | Marketing, product, legal, and multi-column footer patterns | Open Footer |
| Dock | macOS dock and Windows taskbar patterns | Open Dock |
| Window | macOS and Windows window chrome with embedded content | Open Window |
Visual design
| Component | What it includes | Gallery |
|---|---|---|
| Mockup | iOS, iPad, macOS laptop, and MacBook presentation frames | Open Mockup |
| Page Transition | Vertical, horizontal, split, diagonal, radial, and curtain transitions | Open Page Transition |
| Carousels | Eight centered, stacked, coverflow, filmstrip, orbit, and expanding carousel rails | Open Carousels |
| Theme Toggle | GIF-mask and view-transition theme switching patterns | Open Theme Toggle |
Installation
Each gallery includes a copy-ready command. The general format is:
npx aura-ui add <component-name>For example:
npx aura-ui add button
npx aura-ui add input
npx aura-ui add page-transitionThe gallery source is intentionally visible so you can copy a single variant or customize its tokens. Check Installation for the full Next.js and Tailwind setup.
Start from the app shell
import Navbar from "@/components/Navbar";
import Hero from "@/components/Hero";
import WindowMockup from "@/components/WindowMockup";
import BentoGrid from "@/components/BentoGrid";
import Marquee from "@/components/Marquee";
export default function Page() {
return (
<main>
<Navbar />
<Hero />
<WindowMockup />
<BentoGrid />
<Marquee />
</main>
);
}Common patterns
The system leans on a few shared utility classes so the same feel carries across every surface:
<div className="aura-card aura-glass rounded-2xl p-6">
<h3 className="text-fg">A card with Aura styling</h3>
</div>These base classes are defined in app/globals.css and cover the glass look, border system, and motion timing. Use the global tokens for accent colors instead of hardcoding raw hex values.
Navbar
A floating glass nav with a search trigger and theme toggle. It also listens for ⌘K / ⌃K to open the Spotlight command palette.
import Navbar from "@/components/Navbar";
<Navbar />;Hero
A centered launch section with a lime glow, status pill, and large display headline built with the font-display token set.
Window Mockup
The desktop-style preview component is ideal for showing product shots, code snippets, or dashboards in a macOS-inspired frame.
Bento Grid
A responsive grid with varied card spans, designed for feature highlights and content tiles. The layout rhythm is intentionally tight and modular.
Marquee
Use the marquee for low-noise updates, changelogs, or feature announcements. It is CSS-based and inherits the project motion and color tokens.
Spotlight
The search palette is keyboard-first and pairs with the nav search trigger. It is a good fit for navigating docs, commands, or product actions inside an app shell.
import Spotlight from "@/components/Spotlight";
<Spotlight open={open} onClose={() => setOpen(false)} />;Styling tips
- Keep accent colors in the theme tokens instead of custom inline colors.
- Use
text-fg,text-fg-muted, andbg-accent-primaryfor consistent surfaces. - Prefer
transition-allandvar(--ease-aura)for motion that matches the rest of the product. - Use
aura-cardandaura-glassas the default starting points for new panels.