Templates Shell design

Shell design

Menus, themes, top bars, sidebars, layouts, widgets, and actions for the app shell.

Menus Themes Top bars Sidebars Layouts Widgets Actions

Menu structure

Homemenu.home

Contactsmenu.contacts

Dealsmenu.deals

Reportsmenu.reports

Settingsmenu.settings

Item properties

Label

Icon

Target page

About this page

The frame around every page — navigation, header, the chrome that makes an app feel like one product. Shells are versioned assets with reference checks, so renaming something the shell points at gets flagged before it ships.

Behind this page/templates/shell · CanManageTemplates

Retrieve

Reads over TemplateMenus, TemplateThemes, TemplateTopBars, TemplateSidebars, TemplateLayouts, TemplateWidgets, TemplateActions.

Save

Versioned assets publish via sp_PublishTemplateVersion (Page/Theme/TopBar/Sidebar/Module). Menu/Layout/Widget/Action have no publish-mirror branch yet.

Success

Seven asset types share one editor.
Preview renders the composed shell.
Confirm live-row vs versioned per type.

CLI handoff

Implement this scaffold from the structured contract, then remove hard-coded preview rows. The source of truth is CLI Handoff and admin-cli-manifest.json.

Page IDtemplate-shell-design

Route/templates/shell

AccessCanManageTemplates

Statuscatalog-schema-ready-content-not-seeded

Server-inject identity and scope values; never trust browser-supplied account, app, tenant, user, entitlement, price, or permission identifiers. Preserve the loading, empty, forbidden, failed, retrying, and completed states shown by the preview.