Metadata-Version: 2.4
Name: vanta-admin
Version: 0.23.3
Summary: A sharp, dark, and portable Django admin theme forged for builders who want the admin to feel less default.
Author: oli-dev0
License-Expression: MIT
Project-URL: Homepage, https://vanta-admin.org/
Project-URL: Documentation, https://github.com/oli-dev0/vanta-admin-theme/blob/main/README.md
Project-URL: Repository, https://github.com/oli-dev0/vanta-admin-theme
Project-URL: Issues, https://github.com/oli-dev0/vanta-admin-theme/issues
Classifier: Framework :: Django
Classifier: Framework :: Django :: 6.0
Classifier: Framework :: Django :: 6.1
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: Django<6.2,>=6.0
Dynamic: license-file

# Vanta Admin
Vanta Admin is a Django admin theme with a darker interface, tighter density,
and a standalone structure that stays close to Django's admin template system.

It is designed to be portable and to avoid frontend runtime dependencies outside
standard Django admin behavior. You still use Django admin; Vanta changes the
shell, navigation, common controls, messages, and visual treatment so the admin
feels more deliberate in everyday use.

[More info](https://oli-dev0.me/projects/vanta-admin/)

[Live demo](https://demo.vanta-admin.org/)

## What It Is

Vanta Admin is a complete Django admin template for projects that want a more
focused, consistent interface without replacing Django's built-in admin
system. It gives you a ready-made visual layer for everyday admin work, with a
portable structure that stays close to Django's template system.

It includes the main admin shell, navigation, forms, tables, messages, account
screens, responsive layouts, and optional matching templates for
`django-two-factor-auth`. The links above show the full feature set in context.

Vanta Admin does not replace Django admin, change your permissions, or configure
two-factor authentication for you. If your project uses `django-two-factor-auth`,
Vanta provides matching templates and CSS for the visible 2FA screens.

## Tested With
Vanta Admin supports:

- Python 3.12 and 3.13
- Django 6.0 and 6.1

All four combinations are covered by the compatibility test matrix.

Django 6.1 uses Django's native Content Security Policy nonce support. Django
6.0 remains fully supported without nonce attributes and renders form assets
normally.

## Installation

### PyPI with pip
```bash
pip install vanta-admin
```

### PyPI with uv
```bash
uv add vanta-admin
```

## Updating

### With uv
From your project root, resolve the newest Vanta Admin release and sync the environment:

```bash
uv lock --upgrade-package vanta-admin
uv sync
```

This works with the normal constraint created by `uv add vanta-admin`. If you
have deliberately pinned an exact Vanta Admin version, update that pin first.

### With pip
```bash
pip install --upgrade vanta-admin
```

## Django Setup
In your Django settings file, add `vanta_admin` to `INSTALLED_APPS` before
`django.contrib.admin` so its templates override the default admin templates.

This is usually in `settings.py`, or in your project's active settings module
if you split settings across multiple files:
```python
INSTALLED_APPS = [
    'vanta_admin',
    'django.contrib.admin',
    # ...
]
```

Then run your normal static asset flow for Django:
```bash
python manage.py collectstatic
```

## Optional Two-Factor Auth Theme Support

If your project already uses `django-two-factor-auth`, place `vanta_admin` before
the two-factor apps and before `django.contrib.admin` so Vanta's templates are
found first:

```python
INSTALLED_APPS = [
    'vanta_admin',
    'django_otp',
    'django_otp.plugins.otp_static',
    'django_otp.plugins.otp_totp',
    'two_factor',
    'django.contrib.admin',
    # ...
]
```

Configure `django-two-factor-auth` normally in your project URLs and settings.
Vanta only provides the theme layer.

## Notes
- The package name on PyPI is `vanta-admin`.
- The Django app label you add to `INSTALLED_APPS` is `vanta_admin`.
- Two-factor auth support is visual/template support for projects that already
  install and configure `django-two-factor-auth`.
- Vanta keeps Django admin server-rendered. It does not add a frontend runtime
  or a custom dashboard framework.

## Links
- Website: https://vanta-admin.org/
- Live demo: https://demo.vanta-admin.org
- Repository: https://github.com/oli-dev0/vanta-admin-theme
- More info: https://oli-dev0.me/projects/vanta-admin/
