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.

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().

See also​