WidgetGlass

#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-glass

import { WidgetGlass } from 'aura-glass'

import 'aura-glass/styles';

#Examples

Three baseline shapes flagship components use across docs and AI-agent guidance:

import { WidgetGlass } from 'aura-glass';
import 'aura-glass/styles';

export function WidgetGlassExample() {
  return (
    <WidgetGlass
      aria-label="Card example"
    />
  );
}

import { WidgetGlass, GlassCard } from 'aura-glass';
import 'aura-glass/styles';

export function WidgetGlassSurface() {
  return (
    <GlassCard depth="medium" tint="neutral">
      <WidgetGlass
        aria-label="Card production surface"
      />
    </GlassCard>
  );
}

import { WidgetGlass, GlassCard } from 'aura-glass';
import 'aura-glass/styles';

export function WidgetGlassContainedPreview() {
  return (
    <GlassCard style={{ maxWidth: 420 }}>
      <WidgetGlass />
    </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.

#Related Components