AuraGlass by AuraOne

v5.0.2 is the current release (the 5.0 GA shipped 2026-10-13). It is published on the latest dist-tag; npm install aura-glass installs 5.0.2. Migrating from 4.x: npx aura-glass-cli migrate 4to5. All aura-glass versions below 5.0 are deprecated on npm; 4.1.0 remains available under the v4-lts dist-tag for fixes + security — see docs/release/lts-policy.md.

npm dist-tags today (checked by verify-release-comms --dist-tags):

• latest: 5.0.2
• next: none
• v4-lts: 4.1.0

AuraGlass is a liquid-glass design system for React 19. One material engine renders every glass surface; components, product surfaces and copyable registry blocks sit on top of it, styled through CSS layers and design tokens you can override.

At this release: 114 components ·

packed tarball 0.66 MB. Every number on this page is generated from the release pipeline's artifacts (scripts/docs/gen-claims.mjs); a value that has not been measured yet reads "pending".

Quick start

1. Create the app:

   npx create-next-app@latest my-app --yes
   cd my-app
   

2. Install AuraGlass:

   npm install aura-glass
   

3. Set up AuraGlass:

   npx aura-glass-cli@latest init --yes
   

4. Add the app-frame block:

   npx aura-glass-cli@latest add app-frame --yes
   

5. Render it — replace app/page.tsx with:

   import { AppFrame } from '../components/aura/app-frame';
   
   export default function Page() {
     return <AppFrame />;
   }
   

6. Start the dev server:

   npm run dev
   

Without Tailwind, or on Vite: docs/quickstart/next.md and docs/quickstart/vite.md.

Surfaces

Import from the subpath that matches the job; each subpath is its own entry with its own types and CSS.

Import	What it gives you
aura-glass	Core components: Button, TextField, Select, Combobox, Menu, Dialog, Sheet, Popover, Tooltip, Toast, layout (Stack, Grid, Container) and more
aura-glass/material	The glass material engine: surfaces, thickness and variant tiers
aura-glass/theme	AuraGlassProvider, presets, scheme, contrast and motion preferences
aura-glass/tokens, aura-glass/motion	Design tokens and motion springs as typed values
aura-glass/primitives, aura-glass/icons, aura-glass/forms	Unstyled building blocks, the icon set and form bindings
aura-glass/app-shell	Application frame: AppShell, Sidebar, TopBar, Inspector, ResizablePanels, MobileShell
aura-glass/data, aura-glass/date	Table, TreeView, FilterBar, StatCard, ChartFrame; Calendar, DatePicker, DateRangePicker, TimePicker
aura-glass/ai	Thread, Message, Composer, ToolCall, Reasoning, Citation, UsageMeter for AI products
aura-glass/media, aura-glass/backdrops	MediaControls, NowPlayingBar, ImageViewer, CarouselRail; Backdrop scenes behind glass
aura-glass/three	3D scenes (the chart frame, ChartFrame, ships in aura-glass/data)

CLI and registry

The CLI installs registry items as source you own and keeps them current:

npx aura-glass-cli init              # components.json + token aliases
npx aura-glass-cli add app-frame     # install a block or item
npx aura-glass-cli list              # browse the registry
npx aura-glass-cli diff app-frame    # compare your copy with the registry
npx aura-glass-cli update app-frame  # pull registry changes
npx aura-glass-cli doctor            # check versions, peers and CSS layers
npx aura-glass-cli migrate 4to5 --dry-run   # preview the 4.x → 5.0 codemods

Registry items are shadcn-format JSON, so the shadcn CLI installs them too:

npx shadcn@latest add https://auraglass-48859d.gitlab.io/r/app-frame.json

Peer dependencies

Generated from package.json: an optional peer is only needed by the subpath that imports it.

Package	Range	Required
@internationalized/date	^3.12.4	optional
@react-three/drei	^10.0.0	optional
@react-three/fiber	^9.0.0	optional
d3-scale	^4.0.2	optional
d3-shape	^3.2.0	optional
motion	^12.0.0	optional
react	^19.0.0	required
react-aria-components	^1.21.1	optional
react-dom	^19.0.0	required
react-hook-form	^7.0.0	optional
tailwindcss	^4.0.0	optional
three	>=0.170.0	optional

Links

• Quick starts: Next.js · Vite
• Upgrading from 4.x: npx aura-glass-cli migrate 4to5 and the LTS policy
• Changelog · Contributing · Security
• License

SEO pass — 2026-10-20 (docs site)

apps/docs completed the portfolio-standard SEO pass. Nothing deployed; all absolute URLs derive from PUBLIC_DOCS_URL (GitLab Pages placeholder https://auraglass-48859d.gitlab.io/ until OD-12 lands the custom domain — scripts/docs/paths.mjs is the single switch).

• apps/docs/app/robots.ts — explicit Allow groups for 14 named AI crawlers (GPTBot, OAI-SearchBot, ChatGPT-User, ClaudeBot, Claude-Web, anthropic-ai, PerplexityBot, Perplexity-User, Google-Extended, Applebot-Extended, Amazonbot, Meta-ExternalAgent, cohere-ai, CCBot) plus *; every group disallows the one real non-page route, /nav.json (site chrome JSON). Absolute sitemap reference.
• apps/docs/app/sitemap.ts — exact route bijection: / plus every buildSite route (184 URLs at pass time) with a build-time drift guard against the committed lastmod table. Trailing-slash URLs match trailingSlash: true and the per-page canonicals.
• scripts/docs/gen-sitemap-lastmod.mjs (npm run docs:sitemap, --check drift guard docs:sitemap:check) — git-derived per-route lastmod into apps/docs/lib/seo/route-lastmod.json; the check also fails if the route set drifts or the robots policy regresses.
• Per-page metadata — every page now carries a unique title, an honest derived description (markdown first-paragraph or the page's own fields), a trailing-slash canonical, and OG title/description/url; brand renders (og-1200x630 / twitter-1200x600) inherit from the root layout with metadataBase resolving them absolute. Home uses the frozen line "AuraGlass — a liquid-glass design system for React 19".
• llms.txt.tmpl / llms.txt — sitemap + robots facts and the placeholder-domain swap-note appended to the Optional section (generated files stay in sync via npm run docs:llms).