About

The shell every hub of the OpenHubs line shares: the application and public layouts (shell('app'), shell('public')), the sidebar drawn from the menu registry, the header with its search slot, the footer, the flashed messages and the 400, 401, 403, 404 and 500 pages, on theme's site object and tokens, with AdminKit's Bootstrap, Inter and the chrome's icons from npm

Provides

This feature declares no public contract surface.

Configuration

Setting Default What it does
HUB_SHELL_LOGO_COMPACT empty The hub's name, logo, tagline, icons and brand colours are theme's (SITE_NAME, SITE_LOGO, SITE_TAGLINE, THEME_TOKENS); these are what theme has no key for. Each is empty by default, and the shell then draws nothing in its place. The small logo of a phone's header, where the sidebar is a drawer: a path inside the product's static folder. Empty draws the site's name.
HUB_SHELL_FOOTER_YEAR empty The year of the footer's copyright, as in "2025©".
HUB_SHELL_FOOTER_CREDITS empty Who the footer credits, after the year.
HUB_SHELL_REPOSITORY_URL empty The repository of the hub's source code. The footer links it, and the sidebar links the release the site runs to its notes there.

These are the defaults. A product changes them in its own pyproject.toml, under [tool.splent.config], or in .env.deploy in production.

Dependencies

Requires
Works better with

In product lines

Extension points

Hook slots
layout.anonymous_sidebarlayout.authenticated_sidebarlayout.footerlayout.head.csslayout.header.menulayout.navbar.anonymouslayout.navbar.authenticatedlayout.navbar.itemslayout.navbar.userlayout.scriptslayout.sidebar.authenticated.itemslayout.sidebar.top
Templates
400.html401.html403.html500.htmlbase_template.htmlhub_shell/app.htmlhub_shell/errors/400.htmlhub_shell/errors/401.htmlhub_shell/errors/500.htmlhub_shell/public.html
Routes
A refinement can add routes to its blueprint

Other features fill its hook slots. A refinement can override its templates and services or extend its models without forking it.

Compatibility

Python
>=3.13
SPLENT framework
>=1.30.0