# ISIS v2 WS11-007: Responsive Layouts for Creative Workstations and Tablets

## 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

1. Introduced responsive workspace shell architecture in `AppLayout`:

- added `isis-workspace-shell` wrapper around navigation + main workspace,
- enables breakpoint-dependent composition instead of fixed stacked sections.

2. 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.

3. 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.

4. 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: 768px` and
  `max-width: 520px`) while integrating the new shell structure.

5. Extended structural test coverage:

- `AppLayout.spec.tsx` now 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.
