RFD 1114 details: tokens, forbidden changes, checklist
Sourced from app-chrome-layout-protected.mdc, collapsed-rail-icons.mdc, and sidebar-z-index.mdc (user-confirmed good state, 2026-06-18).
Tokens
| Token | Purpose | Owner |
|---|---|---|
--app-content-top |
Measured top offset, read by the right rail | :root, from App.jsx; never .app |
--collapsed-rail-width |
Collapsed rail width, both sides | .app |
--collapsed-rail-icon-width / -icon-height |
Icon button size, matches the scene-controls hamburgers at 40x40 | .app |
--collapsed-rail-icon-gap |
Vertical gap between icons | .app |
--collapsed-rail-icon-padding |
Icon column padding | .app |
--z-side-panel |
Side panel z-index, 998 | .app |
--z-app-header |
Header z-index, 1001 | .app |
--z-scene-controls |
Scene controls row z-index, 1002 | .app |
Forbidden without an explicit user request
- A fixed task bar with a hardcoded
top(for example52px), or a z-index above the header band. - The right rail’s
topset from--app-chrome-top-heightalone, without--app-content-top. - An asymmetric
padding-topon one collapsed rail only. - Removing the
TaskAdvancedOptionsimport fromTaskManager.jsx. - A side panel z-index raised past 998 to fix an overlap; fix
topinstead.
Protected files
App.jsx, App.css, TaskProgressBar.jsx, TaskProgressBar.css, TaskManager.jsx (the TaskAdvancedOptions import), src/pages/Appearance*.{css,jsx}, BottomDisplayMenu.jsx.
Visual check, before merging a layout touch
Both rails collapsed: icon rows align, row for row, left to right. A running task: the progress bar sits below the scene-controls row, the header stays clickable, and both rails stay aligned.