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
In product lines
-
openhubs_spl
In every product
Needs
themeauthicons
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