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

ComponentWhat it includesGallery
ButtonAnimated, glass, gradient, clay, and action button variantsOpen Buttons
InputText, search, leading-icon, trailing-icon, and focused input statesOpen Inputs
Image UploaderUpload, preview, crop, zoom, rotate, and confirm statesOpen Image Uploader
SelectBasic, searchable, grouped, and multi-value dropdownsOpen Select
CheckboxTen animated checkbox and selection patternsOpen Checkboxes

Display

ComponentWhat it includesGallery
CardsInteractive surface and content card layoutsOpen Cards
BadgesStatus, notification, label, and animated badge variantsOpen Badges
LoadersTen loading indicators for async and branded statesOpen Loaders
TablesDense, responsive, and interactive data table patternsOpen Tables
Avatar StackPhoto, initials, grouped, and animated avatar stacksOpen AvatarStack
ProgressLinear, circular, segmented, and animated progress statesOpen Progress
ComponentWhat it includesGallery
NavbarApple, macOS, iOS glass, dashboard, and mega-menu navigationOpen Navbar
ToastFeedback, action, progress, mobile, and animated notification statesOpen Toast
TooltipBasic, rich, delayed, and smart-positioned tooltipsOpen Tooltip
FooterMarketing, product, legal, and multi-column footer patternsOpen Footer
DockmacOS dock and Windows taskbar patternsOpen Dock
WindowmacOS and Windows window chrome with embedded contentOpen Window

Visual design

ComponentWhat it includesGallery
MockupiOS, iPad, macOS laptop, and MacBook presentation framesOpen Mockup
Page TransitionVertical, horizontal, split, diagonal, radial, and curtain transitionsOpen Page Transition
CarouselsEight centered, stacked, coverflow, filmstrip, orbit, and expanding carousel railsOpen Carousels
Theme ToggleGIF-mask and view-transition theme switching patternsOpen 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-transition

The 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.

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, and bg-accent-primary for consistent surfaces.
  • Prefer transition-all and var(--ease-aura) for motion that matches the rest of the product.
  • Use aura-card and aura-glass as the default starting points for new panels.