cadence-ui/docs/exec-plans/2026-03-25-analytics-workspace-showcase.md

Analytics Workspace Showcase

• Status: completed
• Owner: codex
• Date: 2026-03-25

Goal

Add a full-screen Storybook scene that proves the current Cadence UI component set can compose a polished revenue operations dashboard similar to the provided reference without introducing one-off primitives or drifting away from the active Material-inspired design language.

Scope

• In scope:
  • add one new Scenes Storybook story for a revenue analytics workspace
  • compose the page from the existing component surface plus lightweight layout-only markup
  • keep the scene responsive so it remains readable on desktop and mobile widths
  • validate the result in Storybook and through the docs build
• Out of scope:
  • adding new shared components or changing existing component APIs
  • matching the reference screenshot's exact monochrome branding over Cadence UI's active tonal system
  • adding this scene to the curated smoke contract unless it becomes a required regression surface

Constraints

• Follow DESIGN.md over the raw screenshot when visual details conflict.
• Reuse existing components such as Card, Input, Badge, Avatar, Button, Tabs, and Progress.
• Keep the implementation isolated to docs surfaces unless a clear shared gap appears.

Affected Surfaces

• apps/docs/src
• docs/exec-plans

Plan

1. Add an execution plan so the scene work is resumable and reviewable.
2. Build a new full-screen Storybook scene that mirrors the reference information architecture: sidebar, hero header, KPI cards, trend chart, and AI summary panels.
3. Use the running Storybook instance to inspect spacing, hierarchy, and responsive behavior.
4. Run the narrowest useful docs validation suite and record the outcome.

Validation

• pnpm harness:validate:docs
• browser review against the local Storybook instance on http://localhost:6006/

Orchestration Task Sketch

• T1: add the new dashboard showcase scene
• T2 -> T1: inspect and validate the scene in Storybook

Status Log

• 2026-03-25 15:45 started plan for a new Storybook dashboard scene based on the supplied analytics reference
• 2026-03-25 16:02 added Scenes/Revenue Dashboard, verified pnpm harness:validate:docs, and reviewed desktop/mobile rendering against the local Storybook iframe
• 2026-03-25 16:04 noted an unrelated existing Storybook dev-index failure from apps/docs/src/components/progress.stories.tsx that does not block direct iframe review of the new scene