Skip to content

CAP-PFM-CSH-002Fit the page to the available workspace

Markdown

CAP-PFM-CSH-002

Fit the page to the available workspace

Markdown
  • DocumentDraft
  • Product intentProposed
  • ImplementationObserved

KindCapabilityProduct areaPlatformModuleConsole Shell and NavigationRevision2

Read atreact-console baf6dae3services-platform ad3f6a65

The Formal Contract

The narrative above explains; the sections below are authoritative — the rules, scenarios and tests this document binds.

Outcomes
Screens choose between two common layout widths.Space-intensive work can temporarily reduce the navigation footprint.
Surfaces
console
Intent sources
react-console:docs/page-layouts.md#2026-10-12 — Final acceptance (accepted by Andrew 2026-10-12)

Controls

17 controls apply, from the corpus control catalogue.

TC-AZ-001 TC-AZ-002 TC-AZ-003 TC-AZ-004 TC-DAT-001 TC-DAT-003 TC-PI-001 TC-PI-003 TC-PI-005 TC-PRV-001 TC-PRV-002 TC-TEN-001 TC-TEN-002 TC-TEN-003 TC-VEN-001 TC-VEN-002 TC-VEN-003

Permissions

KeyChecked atScope
console.accessconsoletenant

Business Rules

7 rules, 5 to be proved before approval. A rule's product intent is derived from its origin: 0 confirmed by a product decision, the rest inheriting this capability's proposed.

IdRuleKindEnforced atProvenance
01must prove
Proposed
Full width is the default and fills the available content workspace; standard width centers a column capped at 1,100 pixels within that workspace.
origin: react-console:docs/page-layouts.md#2026-10-12 — Final acceptance (accepted by Andrew 2026-10-12)
no proof recorded yet
invariantconsoletest
react-console:components/console/__tests__/page-layout.test.tsx#centers a standard page in a capped inner column, with the page's classes on that column
02
Proposed
The rendering screen selects its width rather than deriving it from an address or surrounding console area.
origin: react-console:docs/page-layouts.md#2026-10-12 — Final acceptance (accepted by Andrew 2026-10-12)
policyconsoledocumented
03must prove
Proposed
The inspected choosers, fields and forms lists, roles and policies select standard width, Tasks and the field editor select full width, and configuration editors may opt into standard width.
no proof recorded yet
policyconsoleobserved
04
Proposed
The layout places margins on the outer container so page content shares one left alignment.
origin: react-console:docs/page-layouts.md#2026-10-12 — Final acceptance (accepted by Andrew 2026-10-12)
invariantconsoletest
react-console:components/console/__tests__/page-layout.test.tsx#keeps the gutters on the outer element only
05must prove
Proposed
Record overview screens and designers are required by the layout record to collapse navigation while open and restore it on departure only when it was expanded on arrival.
origin: react-console:docs/page-layouts.md#2026-10-12 — Final acceptance (accepted by Andrew 2026-10-12)
no proof recorded yet
lifecycleconsoledocumented
react-console:docs/page-layouts.md#Pages that collapse the sidebar
06must prove
Proposed
Collapsing navigation enlarges full-width content while standard content remains centered, and docking the assistant reduces the workspace available to both.
origin: react-console:docs/page-layouts.md#2026-10-12 — Final acceptance (accepted by Andrew 2026-10-12)
no proof recorded yet
invariantconsoletest
react-console:e2e/layout/page-layouts.spec.ts#the keyboard shortcut collapses it too
07must prove
Proposed
Each console load starts with expanded navigation even though changes to that choice are written to browser storage.
no proof recorded yet
lifecycleconsoleobserved

Scenarios

IdGivenWhenThenProvenance
01Contact Types opens on a wide display.The page is rendered.Its list and header occupy the centered standard column.test
react-console:e2e/layout/page-layouts.spec.ts#contact types stays standard and centred
02Navigation is expanded before the contact form designer opens.The person enters the designer and later leaves.The documented expectation is collapse during design and expansion on departure.documented
react-console:docs/page-layouts.md#Pages that collapse the sidebar

The Markdown files under specs/ in rhythmsoftware/rhythm-v2-docs are the canonical source of truth. This reader is a generated, read-only projection of them.