Documentation menu · Compare
Comparison

AuraGlass vs liquid-glass-react

Compare a full Liquid Glass React component system with smaller effect-focused Liquid Glass packages.

#Different Jobs

Effect-focused Liquid Glass packages are useful when the app only needs a material treatment: a refraction layer, blur shader, highlight, or one decorative panel. AuraGlass is broader: it aims to provide production app components that use the material consistently across navigation, data, overlays, dashboards, media, ecommerce, and collaboration.

The decision is scope. If the product team already has components and only wants an effect, a smaller package can be easier. If the team needs a system that gives agents and engineers valid component imports, recipes, tokens, peers, and accessibility guidance, AuraGlass is the more complete starting point.

Small effect package
Material effect or one-off visual layer
AuraGlass
Component system plus material, recipes, docs, and QA guidance
Main risk of effects only
Every app team must still build and maintain the components
Main risk of system
More opinion and dependency surface than a single effect

#When Not to Use AuraGlass

Do not use AuraGlass just to blur one background panel on a page that otherwise uses an established design system. In that case, adding a full component system can be unnecessary dependency and style surface.

Also avoid AuraGlass when the product forbids blur, translucency, or motion for brand, performance, or accessibility reasons. A neutral primitive system will be easier to keep visually quiet.

#Upgrade Path

If a prototype starts with a small visual effect and grows into a product, replace isolated effect wrappers with real AuraGlass surfaces. Start with `GlassCard`, `GlassButton`, and `GlassDashboard`, then add command, data, media, or collaboration components only where the product needs them.

Keep the style import and component imports public. Do not copy internals from either package into the app unless the team is explicitly taking ownership of that code.

tsx
import {
  GlassCard,
  GlassDashboard,
  GlassDataChart,
  GlassDataGrid,
  GlassSidebar,
} from 'aura-glass';
import 'aura-glass/styles';

export function RevenueDashboard() {
  return (
    <GlassDashboard
      title="Revenue command"
      contained
      compact
      maxHeight={720}
    >
      <GlassSidebar contained compact showToggle={false} />
      <GlassCard>
        <GlassDataChart />
      </GlassCard>
      <GlassDataGrid />
    </GlassDashboard>
  );
}