tanstack-desktop-workbench v0.9.0

Highlights

This release contains the complete workbench/scaffolding foundation developed since v0.8.0, not only the AI-context stack entry.

Workbench architecture

• Introduced the canonical preset and feature model with coherent with/without validation.
• Added isolated workbench runtimes and async command support.
• Added declarative registries for commands, layouts, tools, widgets, and status items.
• Added runtime, feature, preset, persistence, menu, shortcut, notification, and viewport test coverage.
• Added the technical-ribbon canonical preset and migrated legacy layout compatibility.

Project scaffolding

• Added generate:project with deterministic, atomic project materialization.
• Added generators for features, widgets, commands, tools, status items, and presets.
• Added exact naming, CLI, template, overwrite, marker, and dry-run safeguards.
• Added clean-by-default derivatives, optional multi-preset generation, and feature pruning.
• Added scaffolding self-tests and validation tooling.

AI context and documentation

• Added generated AI context from real repository state.
• Added project maps, canonical examples, capsule routing, QA checklist, and scaffolding documentation.
• Added generated context freshness checks and controls catalog discovery.
• Added project stack metadata from package.json (package manager and dependency versions).
• Expanded README, preset, architecture, and contributor guidance.

UI and feature improvements

• Added monitoring and operator workbench improvements and validation.
• Added shared primitive controls and theme-token parity checks.
• Added Ribbon and ToolRail visual dividers and adjusted Ribbon height for clearer shell separation.
• Preserved extensibility boundaries: domain/app code stays in src/features/**, while core remains feature-agnostic.

Verification

• bun run validate passes: lint, typecheck, tests, architecture/workbench validation, AI-context freshness, and production build.
• 225 tests passing.

Changes since v0.8.0

• 50 files changed
• 9,011 insertions
• 130 deletions

v0.8.0

Setup wizard preset.

Added:

• Generic useWizard state machine (no-skip, canProceed gating) + WizardShell
• setup preset with Connect to Done demo flow, Back/Next footer
• Branching explicitly out of scope
• 157 tests green

v0.7.0

Monitoring (control-room) preset.

Added:

• Observe-only composition: system summary, source nav, tile wall with sparklines, acknowledge-only alert strip, event stream
• New feature ids: tile-wall, alert-strip, event-stream, system-summary, source-nav
• docs/presets.md: monitoring vs operator guidance
• 127 tests green

v0.6.0

UI states and error boundary.

Added:

• EmptyState, LoadingState/Skeleton, ErrorState primitives
• ErrorBoundary mounted once at router root with retry recovery
• StatesPanel showcase with throw-and-recover demo
• 110 tests green

v0.5.0

Command-fed context menus.

Added:

• Menu model resolving items from registered commands (fail-fast unknown ids)
• Portal overlay with keyboard nav, danger/disabled/separator support
• Opt-in Viewport contextMenu prop, wired in technical-ribbon (zoom + grid)
• Layers row menu and showcase panel
• 110 tests green

v0.4.0

Light theme proving the token architecture.

Added:

• light theme (all --wb-* tokens, data-theme switch, zero component changes)
• ThemeId typing with validated fallback + demo-only runtime switcher
• Theme parity test (99 tests green)

v0.3.0

Global toasts and viewport pan/zoom.

Added:

• Toasts: capped stack, tones, auto-dismiss (errors sticky), hover pause, command actions, mounted once in shell
• usePanZoom: cursor-anchored zoom, drag pan, keyboard, opt-in Viewport prop
• InteractionPanel demo with live x/y/k readout
• 96 tests green

v0.2.0

Showcase, dialogs, command palette and workspace persistence.

Added:

• Controls showcase (/demo/controls): Fields, Toggles, WbButton, Badge, DataTable primitives with Layers and Jobs demo panels
• Modal dialogs: portal Dialog with Confirm/Info wrappers, form/info/confirm/progress demos
• Command palette (Ctrl/Cmd+K) plus global shortcut dispatcher through the command registry
• Workspace persistence (tanstack-workbench:v1 localStorage key) with manifest fallbacks
• 82 tests green

v0.1.0

Initial release of the TanStack Workbench boilerplate.

Added:

• Registry-driven workbench core (commands/tools/widgets/status), no global state manager, no backend
• Fullscreen shell: data-driven Ribbon, ToolRail, generic Viewport, Inspector, CommandBar, StatusBar
• UI primitives, --wb-* design tokens with default ocstudio dark theme
• technical-ribbon preset reproducing the golden reference
• Declarative preset architecture (LayoutPreset slots + FeatureId with/without + validation) driven by src/app/workbench.config.ts
• Four additional presets (ide, studio, operator, minimal) with preview routes
• docs/presets.md, full README, 53 tests green