django-bootstrap6-admin 0.1.0__tar.gz

django_bootstrap6_admin-0.1.0/CHANGELOG.md

@@ -0,0 +1,22 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.0] - 2026-11-15
+
+### Added
+
+- Initial release of the Bootstrap 6 skin for the Django admin.
+- Bootstrap 6 based dashboard, changelist, change form, login, logout and
+  password change pages.
+- Collapsible desktop sidebar, mobile drawer navigation and keyboard support.
+- Light, dark and system themes synchronised with Django's `theme`
+  localStorage preference.
+- Bundled Bootstrap 6.0.0-alpha.1 assets and licence.
+- Support for Django 6.1 on Python 3.12, 3.13 and 3.14.
+- Test suite with a demo Django app and GitHub Actions CI.

django_bootstrap6_admin-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,102 @@
+# Contributing
+
+Thanks for taking the time to improve `django-bootstrap6-admin`.
+
+## Development setup
+
+```bash
+git clone https://github.com/asandikci/django-bootstrap6-admin.git
+cd django-bootstrap6-admin
+python -m venv .venv
+source .venv/bin/activate
+python -m pip install --upgrade pip
+python -m pip install -e ".[dev]"
+```
+
+The test suite uses `tests/settings.py` and a small demo app in
+`tests/testapp/`:
+
+```bash
+python -m django test --settings=tests.settings
+```
+
+Run the linter and formatter check before opening a pull request:
+
+```bash
+ruff check .
+ruff format --check .
+```
+
+## Manual checks
+
+The package only ships templates and static files, so visual changes should be
+checked in a browser as well as in the test suite. A quick way to start a demo
+server is to add a `urls.py` to the test settings and run:
+
+```bash
+python -m django runserver --settings=tests.settings
+```
+
+The demo app is registered at `/admin/` by `tests/urls.py`. Create the
+database and a superuser first:
+
+```bash
+python -m django migrate --settings=tests.settings
+python -m django createsuperuser --settings=tests.settings
+python -m django runserver --settings=tests.settings
+```
+
+## Packaging
+
+Build and validate the distributions locally:
+
+```bash
+python -m build
+python -m twine check --strict dist/*
+```
+
+The wheel must contain the admin templates, the bundled Bootstrap assets and
+the licence files. The CI package job installs the wheel into a clean virtual
+environment and compiles every bundled template as a smoke test.
+
+## Release checklist
+
+1. Update `__version__` in `src/django_bootstrap6_admin/__init__.py`.
+2. Move the `Unreleased` entries in `CHANGELOG.md` into a new version section
+   with today's date.
+3. Run the tests, lint and build checks locally.
+4. Commit the release changes and push them to `main`.
+5. Create and push an annotated tag:
+
+   ```bash
+   git tag -a v0.1.0 -m "django-bootstrap6-admin 0.1.0"
+   git push origin v0.1.0
+   ```
+
+6. The `Release` workflow builds the distributions, verifies that the tag
+   matches `__version__`, and publishes to PyPI.
+
+### One-time PyPI Trusted Publishing setup
+
+The workflow uses OpenID Connect, so no PyPI token is stored in GitHub.
+
+1. Sign in to PyPI and open **Publishing** for the project.
+2. Add a pending publisher with:
+   - **Owner:** `asandikci`
+   - **Repository:** `django-bootstrap6-admin`
+   - **Workflow:** `release.yml`
+   - **Environment:** `pypi`
+3. In the GitHub repository, create an environment named `pypi` under
+   **Settings → Environments**. Add required reviewers or a deployment branch
+   rule if you want a manual approval before publishing.
+
+If Trusted Publishing is not available yet, create a PyPI API token and add it
+as the `PYPI_API_TOKEN` repository secret, then change the publish step to use
+`password: ${{ secrets.PYPI_API_TOKEN }}`. Do not commit tokens to the
+repository.
+
+## Licence
+
+By contributing, you agree that your contributions are licensed under the MIT
+licence used by this project. The admin templates are derived from Django's
+BSD-licensed templates; keep the attribution in `NOTICE` intact.

django_bootstrap6_admin-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Aliberk Sandıkçı
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

django_bootstrap6_admin-0.1.0/MANIFEST.in

@@ -0,0 +1,10 @@
+include LICENSE
+include NOTICE
+include README.md
+include CHANGELOG.md
+include CONTRIBUTING.md
+recursive-include src/django_bootstrap6_admin/templates *.html
+recursive-include src/django_bootstrap6_admin/static *
+recursive-include tests *.py
+global-exclude __pycache__
+global-exclude *.py[cod]

django_bootstrap6_admin-0.1.0/NOTICE

@@ -0,0 +1,48 @@
+django-bootstrap6-admin
+=======================
+
+The admin templates and layout in this package are derived from Django's
+administration templates.
+
+Django
+------
+
+Copyright (c) Django Software Foundation and individual contributors.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice,
+   this list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of Django nor the names of its contributors may be used
+   to endorse or promote products derived from this software without specific
+   prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+Source: https://github.com/django/django/blob/main/LICENSE
+
+Bootstrap
+---------
+
+Copyright (c) 2011-2026 The Bootstrap Authors.
+Licensed under the MIT License.
+
+The bundled license text is at
+`static/django_bootstrap6_admin/vendor/bootstrap/LICENSE`.
+Source: https://github.com/twbs/bootstrap/blob/main/LICENSE

django_bootstrap6_admin-0.1.0/PKG-INFO

@@ -0,0 +1,262 @@
+Metadata-Version: 2.4
+Name: django-bootstrap6-admin
+Version: 0.1.0
+Summary: A modern Bootstrap 6 skin for the Django admin.
+Author-email: Aliberk Sandıkçı <git@asandikci.com>
+Maintainer-email: Aliberk Sandıkçı <git@asandikci.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/asandikci/django-bootstrap6-admin
+Project-URL: Repository, https://github.com/asandikci/django-bootstrap6-admin
+Project-URL: Issues, https://github.com/asandikci/django-bootstrap6-admin/issues
+Project-URL: Changelog, https://github.com/asandikci/django-bootstrap6-admin/blob/main/CHANGELOG.md
+Keywords: django,admin,bootstrap,bootstrap6,theme
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Web Environment
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 6.1
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+Classifier: Topic :: Software Development :: User Interfaces
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: NOTICE
+Requires-Dist: Django<6.2,>=6.1
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == "dev"
+Requires-Dist: twine>=5; extra == "dev"
+Requires-Dist: ruff>=0.6; extra == "dev"
+Dynamic: license-file
+
+# django-bootstrap6-admin
+
+[![CI](https://github.com/asandikci/django-bootstrap6-admin/actions/workflows/ci.yml/badge.svg)](https://github.com/asandikci/django-bootstrap6-admin/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/django-bootstrap6-admin.svg)](https://pypi.org/project/django-bootstrap6-admin/)
+[![Python](https://img.shields.io/pypi/pyversions/django-bootstrap6-admin.svg)](https://pypi.org/project/django-bootstrap6-admin/)
+[![Django](https://img.shields.io/badge/django-6.1-0C4B33.svg)](https://www.djangoproject.com/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+A modern, responsive Bootstrap 6 skin for the Django admin. It replaces the
+default admin templates and static assets without monkey-patching Django,
+changing admin classes, adding database queries, or requiring migrations.
+
+The package is a thin presentation layer: Django's admin views, forms,
+permissions and JavaScript remain in charge.
+
+## Features
+
+- Bootstrap 6 markup and design tokens throughout the admin.
+- Sticky top bar with a collapsible sidebar (desktop) and drawer navigation
+  with a backdrop (mobile).
+- Dashboard with application cards, model shortcuts and recent activity.
+- Changelist with search, date hierarchy, collapsible filters, sortable
+  headers, bulk actions and Bootstrap pagination.
+- Change form with card-based fieldsets, collapsible sections, a clear save
+  bar, tabular/stacked inlines and related-object popups.
+- Modern login, logout and password change pages.
+- Light, dark and system themes. The existing Django `theme` localStorage
+  preference is synchronised with Bootstrap's `data-bs-theme` attribute.
+- Accessible focus states, labels, table headers and ARIA attributes.
+- All Django admin JavaScript hooks are preserved: `actions.js`,
+  `filters.js`, `nav_sidebar.js`, inlines, Select2/autocomplete, calendar
+  widgets and related-object lookups.
+- CSP-aware: bundled scripts and styles use Django 6.1's
+  `{% csp_nonce_attr %}` tag, so nonce-based policies work out of the box.
+- Generic by design: no models, no migrations, no project-specific imports and
+  no assumptions about the host project's branding. The default navy/gold
+  palette is only a set of overridable CSS variables.
+
+## Requirements
+
+| Component | Supported versions |
+| --- | --- |
+| Python | 3.12, 3.13, 3.14 |
+| Django | 6.1.x |
+| Bootstrap | 6.0.0-alpha.1 (bundled) |
+
+Django 6.1 is required because the templates use the
+`{% csp_nonce_attr %}` template tag and the change-form admin actions added in
+that release. Django 5.2 LTS and 6.0 are not supported by this version.
+
+## Installation
+
+```bash
+pip install django-bootstrap6-admin
+```
+
+Add the app **before** `django.contrib.admin` so its `admin/` templates take
+precedence:
+
+```python
+INSTALLED_APPS = [
+    "django_bootstrap6_admin",
+    "django.contrib.admin",
+    "django.contrib.auth",
+    "django.contrib.contenttypes",
+    "django.contrib.sessions",
+    "django.contrib.messages",
+    "django.contrib.staticfiles",
+    # ...
+]
+```
+
+That's it. There are no settings to add, no migrations and no URL changes.
+
+For a local checkout:
+
+```bash
+git clone https://github.com/asandikci/django-bootstrap6-admin.git
+cd django-bootstrap6-admin
+python -m pip install -e .
+```
+
+## What gets overridden
+
+The app provides templates for the standard Django admin pages, including:
+
+- `admin/base.html`, `base_site.html`, `index.html`, `app_list.html`
+- `admin/change_list.html`, `change_form.html`, `delete_confirmation.html`
+- `admin/edit_inline/stacked.html`, `edit_inline/tabular.html`
+- `admin/login.html`, `admin/object_history.html`
+- `admin/auth/user/add_form.html`, `admin/auth/user/change_password.html`
+- `registration/logged_out.html`, `registration/password_change_form.html`
+  and `registration/password_change_done.html`
+
+Only the three auth templates used directly by the admin site are shipped.
+They still live in Django's global `registration/` namespace, so they also
+apply to those views if a project uses them outside the admin; override them
+if you need separate public-site auth screens. Password reset templates are
+intentionally left to the host project, because reset URLs and their branding
+usually belong to the public site rather than to the admin package.
+
+## Customisation
+
+### Long change forms
+
+The action bar sits at the end of the form by default. For long forms, enable
+Django's standard top action bar on a `ModelAdmin`:
+
+```python
+class BookAdmin(admin.ModelAdmin):
+    save_on_top = True
+```
+
+### Branding
+
+Use Django's existing admin site settings:
+
+```python
+from django.contrib import admin
+
+admin.site.site_header = "Acme administration"
+admin.site.site_title = "Acme"
+admin.site.index_title = "Operations"
+```
+
+### Templates
+
+Every block from Django's admin base templates is preserved. Override any
+template normally, for example `templates/admin/base_site.html`, or extend the
+provided template:
+
+```django
+{% extends "admin/base_site.html" %}
+
+{% block branding %}
+  {{ block.super }}
+  <span class="badge badge-subtle theme-info">Internal</span>
+{% endblock %}
+```
+
+### Colours
+
+The skin uses Bootstrap 6 design tokens (`--bs-*`) and a small set of
+`--ba-*` variables. Override them after the admin stylesheet, for example in a
+custom admin CSS file:
+
+```css
+:root {
+    --ba-topbar-bg: #1f2937;
+    --ba-gold: #f59e0b;
+    --ba-sidebar-width: 300px;
+}
+```
+
+The default primary and danger colours are deliberately deeper than Bootstrap
+6's defaults so white button text meets WCAG AA contrast.
+
+The select controls use small `data:` SVG arrows. If you enable a strict CSP,
+allow `img-src 'self' data:` (or replace the arrows in your own CSS).
+
+### Turning it off
+
+Remove `django_bootstrap6_admin` from `INSTALLED_APPS` (or move it after
+`django.contrib.admin`) and the default Django admin returns immediately.
+There is no runtime state to clean up.
+
+## How it works
+
+- The app only contributes templates and static files.
+- Django's admin views and forms are untouched.
+- Django's own JavaScript remains the source of truth for the sidebar state,
+  filters, bulk actions and inlines.
+- The bundled `theme.js` reads and writes Django's `theme` localStorage key and
+  mirrors it to `data-bs-theme`; it does not replace Django's admin behaviour.
+- Bootstrap 6 is pinned as `6.0.0-alpha.1` in
+  `static/django_bootstrap6_admin/vendor/bootstrap/` to keep the visual result
+  stable. Its MIT licence is included next to the assets. SHA-256 of the
+  bundled files:
+  - `bootstrap.min.css`:
+    `678508b198d9b1b8877e338f419fdada00024be2bcc638a539dd724856095112`
+  - `bootstrap.bundle.min.js`:
+    `47ea447f46e288dd9d3e83147b7ba539c6df5192c047b8f91739cd56a5721148`
+
+## Development
+
+The test suite uses an isolated settings module and a small demo app. Create a
+virtual environment and install the package in editable mode:
+
+```bash
+python -m venv .venv
+source .venv/bin/activate
+python -m pip install --upgrade pip
+python -m pip install -e ".[dev]"
+```
+
+Run the tests and the linter:
+
+```bash
+python -m django test --settings=tests.settings
+ruff check .
+ruff format --check .
+```
+
+Build and validate the distribution:
+
+```bash
+python -m build
+python -m twine check --strict dist/*
+```
+
+The same checks run in GitHub Actions on Python 3.12, 3.13 and 3.14.
+
+## Releasing
+
+Releases are published from a `v*` tag with PyPI Trusted Publishing. See
+[CONTRIBUTING.md](CONTRIBUTING.md) for the complete release checklist and the
+one-time PyPI publisher setup.
+
+## Licence
+
+MIT. The admin templates are derived from Django's BSD-licensed admin
+templates, and Bootstrap is distributed under the MIT licence. See
+[NOTICE](NOTICE) and
+`static/django_bootstrap6_admin/vendor/bootstrap/LICENSE` for the full
+attribution and licence texts.

django_bootstrap6_admin-0.1.0/README.md

@@ -0,0 +1,225 @@
+# django-bootstrap6-admin
+
+[![CI](https://github.com/asandikci/django-bootstrap6-admin/actions/workflows/ci.yml/badge.svg)](https://github.com/asandikci/django-bootstrap6-admin/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/django-bootstrap6-admin.svg)](https://pypi.org/project/django-bootstrap6-admin/)
+[![Python](https://img.shields.io/pypi/pyversions/django-bootstrap6-admin.svg)](https://pypi.org/project/django-bootstrap6-admin/)
+[![Django](https://img.shields.io/badge/django-6.1-0C4B33.svg)](https://www.djangoproject.com/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+A modern, responsive Bootstrap 6 skin for the Django admin. It replaces the
+default admin templates and static assets without monkey-patching Django,
+changing admin classes, adding database queries, or requiring migrations.
+
+The package is a thin presentation layer: Django's admin views, forms,
+permissions and JavaScript remain in charge.
+
+## Features
+
+- Bootstrap 6 markup and design tokens throughout the admin.
+- Sticky top bar with a collapsible sidebar (desktop) and drawer navigation
+  with a backdrop (mobile).
+- Dashboard with application cards, model shortcuts and recent activity.
+- Changelist with search, date hierarchy, collapsible filters, sortable
+  headers, bulk actions and Bootstrap pagination.
+- Change form with card-based fieldsets, collapsible sections, a clear save
+  bar, tabular/stacked inlines and related-object popups.
+- Modern login, logout and password change pages.
+- Light, dark and system themes. The existing Django `theme` localStorage
+  preference is synchronised with Bootstrap's `data-bs-theme` attribute.
+- Accessible focus states, labels, table headers and ARIA attributes.
+- All Django admin JavaScript hooks are preserved: `actions.js`,
+  `filters.js`, `nav_sidebar.js`, inlines, Select2/autocomplete, calendar
+  widgets and related-object lookups.
+- CSP-aware: bundled scripts and styles use Django 6.1's
+  `{% csp_nonce_attr %}` tag, so nonce-based policies work out of the box.
+- Generic by design: no models, no migrations, no project-specific imports and
+  no assumptions about the host project's branding. The default navy/gold
+  palette is only a set of overridable CSS variables.
+
+## Requirements
+
+| Component | Supported versions |
+| --- | --- |
+| Python | 3.12, 3.13, 3.14 |
+| Django | 6.1.x |
+| Bootstrap | 6.0.0-alpha.1 (bundled) |
+
+Django 6.1 is required because the templates use the
+`{% csp_nonce_attr %}` template tag and the change-form admin actions added in
+that release. Django 5.2 LTS and 6.0 are not supported by this version.
+
+## Installation
+
+```bash
+pip install django-bootstrap6-admin
+```
+
+Add the app **before** `django.contrib.admin` so its `admin/` templates take
+precedence:
+
+```python
+INSTALLED_APPS = [
+    "django_bootstrap6_admin",
+    "django.contrib.admin",
+    "django.contrib.auth",
+    "django.contrib.contenttypes",
+    "django.contrib.sessions",
+    "django.contrib.messages",
+    "django.contrib.staticfiles",
+    # ...
+]
+```
+
+That's it. There are no settings to add, no migrations and no URL changes.
+
+For a local checkout:
+
+```bash
+git clone https://github.com/asandikci/django-bootstrap6-admin.git
+cd django-bootstrap6-admin
+python -m pip install -e .
+```
+
+## What gets overridden
+
+The app provides templates for the standard Django admin pages, including:
+
+- `admin/base.html`, `base_site.html`, `index.html`, `app_list.html`
+- `admin/change_list.html`, `change_form.html`, `delete_confirmation.html`
+- `admin/edit_inline/stacked.html`, `edit_inline/tabular.html`
+- `admin/login.html`, `admin/object_history.html`
+- `admin/auth/user/add_form.html`, `admin/auth/user/change_password.html`
+- `registration/logged_out.html`, `registration/password_change_form.html`
+  and `registration/password_change_done.html`
+
+Only the three auth templates used directly by the admin site are shipped.
+They still live in Django's global `registration/` namespace, so they also
+apply to those views if a project uses them outside the admin; override them
+if you need separate public-site auth screens. Password reset templates are
+intentionally left to the host project, because reset URLs and their branding
+usually belong to the public site rather than to the admin package.
+
+## Customisation
+
+### Long change forms
+
+The action bar sits at the end of the form by default. For long forms, enable
+Django's standard top action bar on a `ModelAdmin`:
+
+```python
+class BookAdmin(admin.ModelAdmin):
+    save_on_top = True
+```
+
+### Branding
+
+Use Django's existing admin site settings:
+
+```python
+from django.contrib import admin
+
+admin.site.site_header = "Acme administration"
+admin.site.site_title = "Acme"
+admin.site.index_title = "Operations"
+```
+
+### Templates
+
+Every block from Django's admin base templates is preserved. Override any
+template normally, for example `templates/admin/base_site.html`, or extend the
+provided template:
+
+```django
+{% extends "admin/base_site.html" %}
+
+{% block branding %}
+  {{ block.super }}
+  <span class="badge badge-subtle theme-info">Internal</span>
+{% endblock %}
+```
+
+### Colours
+
+The skin uses Bootstrap 6 design tokens (`--bs-*`) and a small set of
+`--ba-*` variables. Override them after the admin stylesheet, for example in a
+custom admin CSS file:
+
+```css
+:root {
+    --ba-topbar-bg: #1f2937;
+    --ba-gold: #f59e0b;
+    --ba-sidebar-width: 300px;
+}
+```
+
+The default primary and danger colours are deliberately deeper than Bootstrap
+6's defaults so white button text meets WCAG AA contrast.
+
+The select controls use small `data:` SVG arrows. If you enable a strict CSP,
+allow `img-src 'self' data:` (or replace the arrows in your own CSS).
+
+### Turning it off
+
+Remove `django_bootstrap6_admin` from `INSTALLED_APPS` (or move it after
+`django.contrib.admin`) and the default Django admin returns immediately.
+There is no runtime state to clean up.
+
+## How it works
+
+- The app only contributes templates and static files.
+- Django's admin views and forms are untouched.
+- Django's own JavaScript remains the source of truth for the sidebar state,
+  filters, bulk actions and inlines.
+- The bundled `theme.js` reads and writes Django's `theme` localStorage key and
+  mirrors it to `data-bs-theme`; it does not replace Django's admin behaviour.
+- Bootstrap 6 is pinned as `6.0.0-alpha.1` in
+  `static/django_bootstrap6_admin/vendor/bootstrap/` to keep the visual result
+  stable. Its MIT licence is included next to the assets. SHA-256 of the
+  bundled files:
+  - `bootstrap.min.css`:
+    `678508b198d9b1b8877e338f419fdada00024be2bcc638a539dd724856095112`
+  - `bootstrap.bundle.min.js`:
+    `47ea447f46e288dd9d3e83147b7ba539c6df5192c047b8f91739cd56a5721148`
+
+## Development
+
+The test suite uses an isolated settings module and a small demo app. Create a
+virtual environment and install the package in editable mode:
+
+```bash
+python -m venv .venv
+source .venv/bin/activate
+python -m pip install --upgrade pip
+python -m pip install -e ".[dev]"
+```
+
+Run the tests and the linter:
+
+```bash
+python -m django test --settings=tests.settings
+ruff check .
+ruff format --check .
+```
+
+Build and validate the distribution:
+
+```bash
+python -m build
+python -m twine check --strict dist/*
+```
+
+The same checks run in GitHub Actions on Python 3.12, 3.13 and 3.14.
+
+## Releasing
+
+Releases are published from a `v*` tag with PyPI Trusted Publishing. See
+[CONTRIBUTING.md](CONTRIBUTING.md) for the complete release checklist and the
+one-time PyPI publisher setup.
+
+## Licence
+
+MIT. The admin templates are derived from Django's BSD-licensed admin
+templates, and Bootstrap is distributed under the MIT licence. See
+[NOTICE](NOTICE) and
+`static/django_bootstrap6_admin/vendor/bootstrap/LICENSE` for the full
+attribution and licence texts.