Install the package
Add django-chassis before django.contrib.admin so templates overlay the stock Admin.
From install to a working admin
Build an AdminSite
Mix in ChassisAdminSiteMixin, set the brand, and declare sidebar, pages, and dashboard blocks.
Compose a ModelAdmin
Mix in ChassisAdminMixin and collect search, actions, and import/export in the options list.
Why Django-Chassis
Declarative options
Frozen option objects describe changelist, actions, and import/export without ad-hoc template forks.
Site-wide chassis
Brand, sidebar, navbar, custom pages, and dashboard contracts live on the AdminSite.
Django native
It extends ModelAdmin and AdminSite. Domain models and business rules stay in the project.
Strongly typed
The package ships py.typed so editors and type checkers can follow the public contracts.
Guides
How it works
Mixins, options, services, templates, and the request path.
Options catalog
Every option: fields, defaults, validation, and UI region.
ModelAdmin
MRO, the options list, Settings, and change-form layout.
Dashboard
Page anatomy, blocks, live widgets, and the four-column grid.
Custom pages
Access contracts, information pages, and object cards.
Import and export
Formats, preview, history, storage, and backends.
Permissions
Group-only checks and custom PermissionOption.