AuraGlass 3.3 Release Notes — AuraGlass by AuraOne

#What 3.3 ships

AuraGlass 3.3 is the post-3.2 trust release. The package keeps the dependency-sovereign app chrome from 3.2 and adds focused package subpaths for forms, data, navigation, overlays, workflows, and marketing so product teams can import smaller feature families with clearer ownership.

The registry now exposes 28 recipes. Eight new 3.3 starters cover AI operations, semantic search, vision review, collaboration room state, support triage, release operations, developer docs, and marketing launch pages. AI/server recipes default to provider-unconfigured UI states until the app wires authenticated provider-backed routes.

#Focused package subpaths

Use focused subpaths when a route only needs one product family. The root entrypoint remains convenient for core UI, while the subpaths make package boundaries easier to review in dashboards, form flows, data-heavy routes, overlays, workflow screens, and launch pages.

aura-glass

Core components: Button, Card, Dialog, Sheet, Popover, Tabs, CommandPalette, Surface, AuraGlassProvider

aura-glass/app-shell

AppShell, Sidebar, TopBar, StatusBar, Inspector, MobileShell

aura-glass/data

Table, TreeView, FilterBar, StatCard, Sparkline, ChartFrame

aura-glass/date

Calendar, DatePicker, DateRangePicker, TimePicker

aura-glass/ai

Thread, Message, Composer, ToolCall, Reasoning, Citation

aura-glass/media

MediaControls, ImageViewer, NowPlayingBar, CarouselRail

aura-glass/compat

Deprecated 4.x names kept working during migration, each with a warning

#Hosted runtime contract

The optional hosted runtime is documented as opt-in. Core package use still requires only React, React DOM, the package, and the stylesheet. Backend features require explicit API, WebSocket, Redis, auth, and provider configuration by the consuming app.

3.3 standardizes the local contract around API `3002` and WebSocket `3001`, with fail-closed provider-unconfigured responses. Missing AI/search/vision provider configuration should produce typed, secret-safe errors and disabled provider-backed actions rather than mock success.

API server

http://localhost:3002 for optional provider-backed routes

WebSocket server

ws://localhost:3001 for optional room, presence, cursor, and selection state

Provider missing

Render provider-unconfigured UI and keep manual review paths usable

Collaboration editing

Explicitly unsupported until a real CRDT/OT operation model ships

#Recipe registry

In 5.0 the CLI moved to the separate `aura-glass-cli` package and the 4.x package recipe-registry subpath was removed. Use `npx aura-glass-cli list` to browse registry blocks and `npx aura-glass-cli add <block>` to install one as owned source.

bash

npx aura-glass-cli list
npx aura-glass-cli add app-frame
npx aura-glass-cli doctor

#Upgrade checklist

Upgrade apps by installing `aura-glass@3.3.0`, keeping the stylesheet import at the app root, replacing stale recipe counts in local docs, and moving new feature routes to focused package subpaths when that makes bundle review clearer.

Treat backend features as opt-in. Do not claim provider-backed AI, semantic search, vision review, or collaboration editing is production-ready until the consuming app has configured provider keys, auth, Redis, route policy, monitoring, and its own integration tests.

bash

npm install aura-glass@3.3.0
npx aura-glass-cli doctor --json
npx aura-glass-cli list --json