Scope#
WS11-007 introduces breakpoint-aware layout behaviors tuned for:
- desktop creative workstations (high-width monitoring + authoring surfaces),
- tablets (compact but high-density production workflows),
- existing mobile fallback behavior.
Research and Existing Implementation Alignment#
Implementation is grounded in current ISIS web structure and existing responsive patterns already used in OSHUN:
- ISIS shell + page styling baseline:
apps/isis/web/src/components/AppLayout.tsx,apps/isis/web/src/components/AppLayout.css - OSHUN responsive shell/sidebar references reviewed for breakpoint strategy and
workspace density:
apps/oshun/web/src/components/ShellLayout.tsx,apps/oshun/web/src/design-system/globals-v2.css
Deliverables#
- Introduced responsive workspace shell architecture in
AppLayout:
- added
isis-workspace-shellwrapper around navigation + main workspace, - enables breakpoint-dependent composition instead of fixed stacked sections.
- Added workstation-optimized layout behavior (
min-width: 1200px):
- two-column layout (
nav rail+main workspace) for wide creative screens, - sticky navigation rail to preserve task context during long-page operations,
- denser nav/link and lane treatment for high-information production sessions.
- Added tablet-optimized layout behavior (
769px-1199px):
- context tabs normalized to full-width 3-column grid,
- filter/tooling rows shifted to stacked controls for reliable touch targets,
- toolbars moved to two-column card grids with full-width status group handling,
- stage lanes and tables tuned for tablet information density.
- Refined base responsive primitives:
- increased shell max width to better utilize workstation viewport area,
- normalized nav/main spacing through
isis-workspace-shell, - preserved existing mobile behaviors (
max-width: 768pxandmax-width: 520px) while integrating the new shell structure.
- Extended structural test coverage:
AppLayout.spec.tsxnow asserts responsive shell container presence (.isis-workspace-shell) alongside existing accessibility checks.
Verification Commands#
bash
pnpm --filter @isis/web exec vitest run src/components/AppLayout.spec.tsx src/components/CreativeWorkflowFrame.spec.tsx src/components/IsisLoadingState.spec.tsx src/components/IsisEmptyState.spec.tsx --reporter=dot
pnpm --filter @isis/web run typecheck
node scripts/isis/generate-remediation-backlog-v2.mjs
node scripts/isis/validate-v2-compliance-gate.mjs
Verification Notes#
- Targeted layout and accessibility tests pass.
- Workspace typecheck remains red due pre-existing unrelated cross-package/rootDir typing issues in baseline repository state.