Shells
A shell is the whole-page chrome — the frame within which features live. Each shell is mobile, tablet, and desktop in one. Shells are kit-scoped: dashboard shells are not portal shells, and portals never inherit dashboard chrome.
Dashboard shells
For the operational product — verticals and shared modules. Anchored to the desktop because that's where ops staff work; reflows down for branch managers on phones.
Portal shells
For audience-facing surfaces. Each portal has its own shell — chrome stripped to what its audience actually needs. Portals never inherit dashboard chrome.
When to use which shell
A simple cheat sheet.
| Use case | Shell | Why |
|---|---|---|
| Branch manager dashboard | Dashboard | Sidebar + table-heavy work, desktop-first |
| Workspace settings | Settings | Section rail keeps subsections discoverable |
| Stock list, customer list, audit log | Data-table | Full-bleed table chrome, sticky headers |
| Cashier on a phone | POS portal | Stripped chrome; thumb-zone keypad |
| Parent checking fees | Parent portal | Mobile-first, low-bandwidth, hero banner |
| Student timetable lookup | Student portal | Tablet calendar grid is the centre of mass |
| Teacher entering marks | Teacher portal | Class-anchored side nav + grading grid |
| Staff payslip download | Staff portal | Same nav model as dashboard, softer surfaces |
| Platform operator | Admin control plane | Dark, dense, desktop-only — feels infrastructural |