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.
Page shells
Per-page chrome that sits inside the dashboard or portal shell. Same composition every time so users always know where the toolbar, save bar, or editor lives. Each one is documented as a b-* block but renders as a page shell.
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 |