GlassBox
A box with the system glass surface applied.
#Overview
#Install and Import
Install the package once, import the component from the public entry, and load styles a single time at the app root.
npm install aura-glassimport { GlassBox } from 'aura-glass'import 'aura-glass/styles';#Examples
Three baseline shapes flagship components use across docs and AI-agent guidance:
Basic
import { GlassBox } from 'aura-glass';
import 'aura-glass/styles';
export function GlassBoxExample() {
return (
<GlassBox
aria-label="Layout example"
/>
);
}Production
import { GlassBox, GlassCard } from 'aura-glass';
import 'aura-glass/styles';
export function GlassBoxSurface() {
return (
<GlassCard depth="medium" tint="neutral">
<GlassBox
aria-label="Layout production surface"
/>
</GlassCard>
);
}Contained
import { GlassBox, GlassCard } from 'aura-glass';
import 'aura-glass/styles';
export function GlassBoxContainedPreview() {
return (
<GlassCard style={{ maxWidth: 420 }}>
<GlassBox />
</GlassCard>
);
}#Accessibility
Keep visible labels and semantic structure around this surface. Confirm keyboard order, focus visibility, disabled states, and text contrast over the actual backdrop used by the app.
#SSR and Performance
Import from the public package entrypoint, load `aura-glass/styles` once, and keep expensive data, media, or animation work outside the visual component unless the product needs it.
#Theming
Theme with public props, `className`, `style`, and AuraGlass CSS variables. Avoid private DOM selectors so the component can upgrade with the package.