Skip to content

Web Workspace Shell

The web workspace shell owns the product navigation structure, responsive layout expectations, and feature grouping for the Nuxt app.

  • Chats, Connectors, Library, Response Templates, Skills, Spaces, and account controls are reachable through shared navigation.
  • The shell supports responsive desktop and mobile layout patterns.
  • Intelligence grouping keeps knowledge and assistant-shaping surfaces together.
  • Top-header submenus use Nuxt UI default triggers, close after route navigation, and the Spaces submenu marks the active scope with an explicit In scope state.
  • Desktop sidebar chat-list scrollbars are thin, muted, and flush to the content edge while section controls keep enough inset spacing.
  • The sidebar account menu groups Settings links with All Settings and Profile above a separator and API keys below it.
  • The /settings page uses the same authenticated app shell as other workspace settings surfaces and stages user setting changes behind the shared page-level Save action.
  • /settings/profile includes Better Auth profile controls for full name and avatar image. Email/password avatars upload through auth-owned first-party storage with a 1 MB input cap, trusted browser-origin checks, and a managed auth path resolved by the web runtime; SSO avatar images come only from trusted provider claims and arbitrary image URL entry is not supported.
  • /settings includes a final Account area for profile and account-access pages such as API keys.
  • /settings includes the private-chat preference Ask clarifying questions, which controls optional source-choice and bounded detail-clarification prompts.
  • Spaces are treated as organizational context rather than an auth or data-boundary replacement.
  • Pre-release local Prisma-backed databases must keep user-settings rows in the canonical shape. The one-time repair for older local optionalChatClarificationRequestsEnabled data was run on 2026-06-24 and removed; if a restored local snapshot reports old-shape drift, clear/regenerate local data or add a reviewed one-off repair instead of adding runtime compatibility reads.
  • Focused-chat boundary hints need a deeper UX pass.
  • Branded error routes remain deferred.
  • Whitelabel theme consumption waits for accepted governance-owned brand settings.
  • docs/features/web-workspace/spec.md
  • docs/features/user-settings/spec.md
  • docs/features/web-workspace/decisions/
  • docs/features/web-workspace/stories/
  • docs/features/web-workspace/tests/
  • apps/web/app