Changelog
Every change to the registry, newest first — one entry per merged PR, tagged with the items it touched.
Machine-readable copies: llms-changelog.txt (full history) and r/versions.json (per-item content hashes for drift detection — see For agents).
- Added
Version management and agent ops landed: every registry item now has a published content hash in `/r/versions.json` (compare against your `nx-ui.lock` to detect drift), this changelog (one entry per PR, browsable at `/changelog`, machine-readable at `/llms-changelog.txt`), the `@nx-ui/nx-ui-doctor` script for consumer-side `lock`/`check`/`wrap-audit`, an agent onboarding page at `/agents`, CI, and scheduled maintenance loops.
nx-ui-doctor - Docs#35
The docs engine: view-code toggles on every demo, generated API/props tables, cross-link chips between related items, per-item markdown cards at `/llms/<name>.md`, a table-of-contents rail and dual-mode preview canvases.
- Fixed
Accessibility wave: all 111 serious findings from the a11y audit cleared across the component suite and showcase — missing accessible names and labels, aria reference integrity, duplicate ids, landmarks and contrast.
- Internal#34
Showcase wayfinding: collapsible nav groups, command-palette upgrades (including recents), a top bar dogfooding ScopeBreadcrumbs, a keyboard-shortcuts dialog, and the first changelog page.
- Fixed#30
Bare `text-tertiary`/`text-quaternary` utilities (which don't exist in the theme) replaced with the correct full-token forms `text-text-tertiary`/`text-text-quaternary` wherever they had crept in.
- Docs#12
Consumer skill bumped to 1.2.0: theme-variant wiring, block install paths and refreshed inventories.
- Added#27
Sidebar-nav scroll affordances via the new `scroll-fade` block, a user-menu organisation section, and breadcrumb Untitled UI parity.
- Fixed#18
Restored the shadcn custom variants and utilities the theme had dropped — `styles/shadcn-compat.css` now ships with the theme item, carrying the `data-*` variants and scroll/shimmer utilities the base-vega components rely on.
theme - Added#19
The scoped app shell for core nx products: optional top bar, org ▸ project scope breadcrumbs with switchers, the two-level sliding sidebar nav, and the app-switcher launcher. `app-shell` gained the top-bar slot (additive).
- Internal#32
Showcase QA tooling: live-preview viewport presets, the `/foundations/theme-matrix` page for eyeballing every brand x mode combination, and a generated design-token reference (`build-token-docs.ts`).
- Internal#14
Showcase preview UX: nav affordances, pointer cursors, and full-width + windowed preview modes.
- Added#31
Three visual-first opportunity surfaces: the proximity map, the cost-proportional flow canvas and the cost-vs-readiness decision grid.
- Added#29
The opportunity matrix family: pathway comparison cards, the options matrix and AI viability surfaces for material-routing decisions.
- Fixed#16
Notification centre rebuilt on the nexus4 anatomy: unread edge bars, severity tiles, date-grouped rows under sticky headers, inline decisions and hover quick actions.
- Internal#11
Motion and polish pass across the showcase — scroll reveals, transitions and consistency fixes.
- Added#24
The componentised marketplace map experience: supercluster bubbles with type-mix rings, the virtualised listings panel, the faceted filter panel, shared listing cards, and the headless orchestrator hooks.
marketplace-maplistings-panellistings-filterslisting-cardmarketplace-typesuse-marketplaceuse-listings-clusters - Added#6
The marketing pattern family: config-driven backdrops, heroes, section primitives, feature rows and cards, CTA band, logo cloud, testimonials, stats band, how-it-works, FAQ, and the site header/footer.
- Added#20
Map tooling: the glass-pill map toolbar, travel-time isochrone overlays, click-to-add waypoint routing (both against the nx-geo contracts), and the cinematic transfer-preview choreography.
- Internal#15
Site header/footer demos now use the real Nexus lockup; the footer watermark reuses `nx-emblem`.
- Docs#33
Home page redesigned (hero band, live registry stats, curated highlights) and a `/docs` section added to the showcase: getting-started, theming, components-and-blocks, app-shell-pattern and contributing guides.
- Internal#10
The examples gallery: full-page compositions served full-bleed at `/view/<slug>` — auth screens, dashboards, settings, error states and the live Movement Control Room.
- Added
DX wave: visual regression (`bun run visual`) and accessibility audit (`bun run a11y`) suites, generated per-component API docs on showcase pages, the `llms.txt`/`llms-full.txt` agent manifests, and the compact density mode (showcase-only theme capability).
- Added#17
Domain modal selector flows: the full EWC List of Wastes lookup modal, the grouped material picker modal with cascading suggestions, and the location field flow with directory search and a map escape hatch.
- Added#9
The TanStack Table data-table kit in the shadcn idiom: sorting, faceted and multi-column filters, global search, row selection with a bulk-action bar, pagination, column visibility and pinning, expandable sub-rows, loading skeletons and empty states — plus tables and charts showcase sections.
data-table - Added
21 new components and blocks in one wave, a brand refresh, and the surface brand-variant themes (ultraviolet, evergreen, ocean, ember, graphite) switched by `data-brand`.
- Added#28
Collapsible open/close motion, the checkbox-card and checkbox-group components, and an accordion badge-gap fix.
- Fixed#26
Glow variants, a brand-fill contrast audit across both modes, and the background-pattern stacking contract.
- Added#8
31 AI Elements ports (`ai-*` items: conversation, message, reasoning, tool, prompt-input, workflow canvas and friends), restyled to the nx look and installing to `components/ai/`.
- Added#4
The Mapbox map suite: a theme-aware `map-view` wrapper plus branded markers, clustered site maps, route maps with progress overlays, boundary polygons and glass stat overlays.
- Added#3
Untitled UI parity wave for forms: date picker, filters, tags, file upload, stepper and friends joined the suite.
- Added#7
The Nexus domain family: EWC (European Waste Catalogue) selector, construction material selector, UK location selector, project-scope selector and compliance checklist, with their reference datasets shipped as `data-*` items.
- Added#5
Untitled UI parity wave for display components, plus the design-flare utilities (`flare-styles`).
- Added
The two-layer design-token foundation landed: the full Untitled UI colour/type/shadow/radius system carrying Nexus navy and Aureolin yellow, mapped onto shadcn's semantic CSS variables, with light and dark driven by `light-mode`/`dark-mode` classes (primary flips navy→yellow in dark).
theme - Internal
Showcase gallery infrastructure and 69 demo pages (59 components + 10 blocks), dogfooding the app-shell blocks as the gallery's own chrome.
- Added
All 60 base components restyled to the Untitled UI look under the minimal-diff doctrine (tokens first, class deltas second, APIs untouched), plus the first 10 app-shell blocks and the registry build system that derives dependencies by parsing imports.
- Internal#2
Showcase preview UX: ⌘K search, brand theme variations behind a picker, and the generated navigation manifest.
- Fixed
Base UI menu labels must sit inside a Group — fixed everywhere and guarded by a new headless interaction smoke test (`bun run smoke`) that clicks every control on every showcase page.
- Internal
Repo scaffolded: Next.js 16 App Router showcase app with the full shadcn base-vega baseline (60 unmodified components) on Base UI primitives, Bun and Tailwind CSS v4.
- Fixed
Removed stale per-component `dark:` overrides that fought the theme's token flip — dark mode now comes entirely from CSS variables.
- Fixed
First consumption-test findings fixed: `shadcn init` guidance, removal of conflicting globals.css scaffolding, and correct consumer install paths for blocks.
- Docs
The two canonical agent skills shipped: `nx-ui-components` (consuming — discovery, install, theme wiring, troubleshooting) and `nx-ui-contribute` (maintaining — the minimal-diff doctrine and registry regeneration).