Tokens First

The registry is shadcn-compatible. Install the token contract once; it defines every Aurora custom property on :root plus the .light remap.

Layer Order (Tailwind v4)

Aurora ships component base styles in @layer aurora-components so your Tailwind utilities always win over them. Declare the layer order once, on the first line of your globals — above @import "tailwindcss". Skip it and the layer lands after utilities, so utilities can no longer override component styles.

Per Component

Each of the 175 registry items installs the same way — primitives and composed blocks alike.

Modern Registry Capabilities

Aurora also publishes a base bundle, starter pages, project-local theme files, and agent artifacts through the same shadcn registry.

Shadcn file targets are project-root scoped. Items that install under ~/.config/aurora create files inside the current project, not inside your real home directory.

Android

Tokens export to Android via Style Dictionary as a Compose Color palette and dimens; the tv.tootie.aurora:aurora library wraps them in AuroraTheme. The same names carry across — aurora_accent_primary, aurora_radius_3.

The Page Shell

Start every page on class="aurora-page-shell". Build working areas on Tier-2 panels: 22px radius, strong border, strong shadow, inset top highlight.