Documentation menu · AI Agents
GEO

Choose the Right AuraGlass Component

Map common user intents to valid AuraGlass component imports.

#Selection Intent Map

Use valid public names before inventing a component. If a user asks for a product surface rather than a single component, compose several components or start from a recipe.

Choose boring, reliable components first. Add 3D, visualizers, or realtime only when the prompt clearly asks for those capabilities.

Premium SaaS dashboard
GlassDashboard, GlassSidebar, GlassCard, GlassDataGrid, GlassDataChart
Command center or AI search
GlassCommandPalette, GlassCard, GlassDataGrid, GlassTabs
Settings and billing
GlassCard, GlassButton, GlassTabs, GlassForm, GlassFileUpload
Data-heavy admin
GlassDataTable, GlassDataGrid, GlassVirtualTable, GlassDataChart
Modal workflow
GlassModal, GlassDialog, GlassDrawer, GlassPopover
Media player
LiquidGlassMediaControls, GlassImageViewer, GlassMusicVisualizer
Kanban or project workspace
GlassKanbanBoard, GlassCard, GlassDrawer, GlassCommandPalette
Calendar or scheduling
GlassCalendar, GlassCard, GlassPopover
Collaboration surface
CollaborativeGlassWorkspace, GlassCollaborativeComments, GlassCard
Ecommerce cart or panel
GlassSmartShoppingCart, GlassProductRecommendations, GlassCard

#Selection Heuristics

For dashboards, prioritize layout and data density: `GlassDashboard`, `GlassSidebar`, `GlassCard`, `GlassDataGrid`, and charts when chart peers are acceptable. For command centers, prioritize keyboard flow: `GlassCommandPalette`, `GlassTabs`, cards, and grids.

For constrained embeds, docs cards, and previews, prefer components that support `contained`, `compact`, `height`, and `maxHeight`. These props prevent viewport-oriented components from escaping their container.

Needs keyboard search
GlassCommandPalette with inline/contained behavior
Needs app chrome
GlassDashboard plus GlassSidebar or GlassNavigation
Needs bounded preview
Use contained/compact and disable portal toggles when available
Needs media
Use LiquidGlassMediaControls and reduced-motion fallback

#Example Composition

A good agent-generated composition has enough props to be believable and bounded. Avoid bare `<Component />` examples when the component normally needs data, state, size, or containment.

tsx
import { GlassCard, GlassCommandPalette, GlassDataGrid } from 'aura-glass';
import 'aura-glass/styles';

export function AiCommandCenter() {
  return (
    <GlassCard depth="medium">
      <GlassCommandPalette
        open
        contained
        compact
        positionStrategy="inline"
        placeholder="Search agents, jobs, and documents..."
      />
      <GlassDataGrid />
    </GlassCard>
  );
}