Skip to main content

Theming

Added in 1.0.1

Chassis ships a complete Admin template overlay and static assets. Domain apps should not copy those templates.

App order​

INSTALLED_APPS = ['django_chassis', 'django.contrib.admin']

'django_chassis' must come first so admin/base.html, login, change list, and change form resolve to the Chassis versions.

Template families​

  • admin/chassis/ — default Chassis shell
  • admin/tabler/ — parallel Tabler-styled family

ChassisAdminMixin points change_list_template and change_form_template at admin/chassis/.... Override those attributes on a ModelAdmin only when you need a local exception.

Static assets​

Under django_chassis/static/admin/chassis/:

  • Admin, dashboard, navbar, sidebar, auth, and error-page CSS
  • ApexCharts, Font Awesome
  • Live dashboard, charts, filters, sidebar, navbar dropdown, table selection, date masks, related pagination

The built-in navbar theme item switches light/dark. See Navbar.

Admin login​

Changed in 1.0.21

The default Admin login card shows its heading and authentication controls without a decorative lock icon. The heading has a compact 20px top inset on desktop and mobile; the empty shell page heading adds no extra space. The project brand remains in the shell header and uses the AdminSite brand settings described below.

Brand​

Changed in 1.0.1

By default Chassis uses the documentation icon (admin/chassis/icon.svg) as the login brand mark and favicon. Set chassis_brand_name and chassis_brand_logo_static_path on the site to replace them, or override get_chassis_brand() / get_chassis_brand_badge(). Set the logo path to None to hide the default icon. Footer content comes from get_chassis_footer_context().

Changed in 1.0.21 Added in 1.0.21

Complete logos preserve their natural aspect ratio. Set chassis_brand_name = None when the image includes the name. Use chassis_brand_favicon_static_path or BrandDTO.favicon_static_path for a separate square favicon; None falls back to the logo.

See also​