# Django
Use AdminKit in a Django project with a base template that loads the CSS and JavaScript from the CDN and a dashboard page that extends it.
Django projects have no JavaScript build step by default, so the simplest integration loads the compiled AdminKit files from the CDN in a base template that your pages extend.
## Install
Create a project and a project-level `templates/` directory:
```bash
pip install django
django-admin startproject config my-app
cd my-app
mkdir templates
```
Register the directory in the template settings:
```python title="config/settings.py"
TEMPLATES = [
{
'BACKEND': 'django.template.backends.django.DjangoTemplates',
'DIRS': [BASE_DIR / 'templates'],
# ...
},
]
```
The AdminKit files load from `https://unpkg.com/@adminkit/core/dist/`. To serve them yourself, copy `dist/` (from `npm pack @adminkit/core`, or from the AdminKit PRO download) into a static directory, because Django serves files only from its static directories, and reference the files with `{% static %}`.
## Import the CSS and JavaScript
The base template loads the stylesheet in `` and `app.js` at the end of ``.
```html title="templates/base.html"
```
### Optional: avoid a color mode flash
Without `head.js`, `app.js` applies the stored [color mode](/docs/getting-started/dark-mode/) once it runs, so a visitor who picked the mode opposite to their operating system briefly sees the other one. `head.js` applies it before the first paint. Load it as a plain script in ``, before the stylesheet:
```html
```
## Minimal layout
```html title="templates/base.html"
{% block title %}Dashboard{% endblock %}
{% endblock %}
```
```python title="config/urls.py"
from django.contrib import admin
from django.urls import path
from django.views.generic import TemplateView
urlpatterns = [
path("", TemplateView.as_view(template_name="dashboard.html"), name="dashboard"),
path("admin/", admin.site.urls),
]
```
## Run
```bash
python manage.py runserver
```
Open http://127.0.0.1:8000. You should see the dark sidebar, the navbar with the hamburger toggle and the card.
## Notes
- The CDN URLs above are unpinned and serve the latest published version. Pin a version in production, for example `https://unpkg.com/@adminkit/core@/dist/js/app.js`.
- Django's admin at `/admin/` keeps its own styling. AdminKit applies only to pages that extend `base.html`.
---
Canonical HTML page: https://adminkit.io/docs/frameworks/django/
Site overview for agents: https://adminkit.io/llms.txt (expanded: https://adminkit.io/llms-full.txt) · Documentation: https://adminkit.io/docs/ · Questions: support@adminkit.io