> For the complete documentation index, see [llms.txt](https://appseed.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://appseed.gitbook.io/docs/boilerplate-code/django-templates/argon-dashboard.md).

# Django Argon Dashboard

Open-source template for Django admin section styled with Argon Dashboard Design (free version)

Modern template for **Django Admin Interface** coded on top of **Argon Dashboard**, an open-source `Boostrap 5` design from `Creative-Tim`.

* [Django Template Argon](https://pypi.org/project/django-admin-argon-dashboard/) - PyPi Page
* [Django Argon Dashboard](https://django-argon-dashboard.appseed-srv1.com/) - LIVE Demo
* [Django Argon Dashboard](https://github.com/app-generator/django-argon-theme-playground) - `playground project`

## Why `Django Argon Design`

* Modern `Bootstrap 5` Design
* `Responsive Interface`
* `Minimal Template` overriding
* `Easy integration`

![Argon Dashboard - Django Template generated by AppSeed.](https://user-images.githubusercontent.com/51070104/183684596-4b29a886-f13d-4da5-98d3-12b5b90df47f.png)

## Installation

```
$ pip install django-admin-argon-dashboard
// OR
$ pip install git+https://github.com/app-generator/django-admin-argon-dashboard.git
```

> Add `admin_argon` application to the `INSTALLED_APPS` setting of your Django project `settings.py` file (note it should be before `django.contrib.admin`):

```python
    INSTALLED_APPS = (
        ...
        'admin_argon.apps.AdminArgonConfig',
        'django.contrib.admin',
    )
```

> Collect static if you are in production environment:

```bash
$ python manage.py collectstatic
```

> Start the app

```bash
$ # Set up the database
$ python manage.py makemigrations
$ python manage.py migrate
$
$ # Create the superuser
$ python manage.py createsuperuser
$
$ # Start the application (development mode)
$ python manage.py runserver # default port 8000
```

Access the `admin` section in the browser: `http://127.0.0.1:8000/`

## How to use it for common users

> `Create view functions` for a particular pages and render the html template.

```python
    def dashboard(request):
        return render(request, 'pages/dashboard.html')
```

> Create `urls.py` file and map the function to the `urls.py` file.

```python
    path('dashboard/', views.dashboard, name="dashboard")
```

> Available pages

* `dashboard.html`
* `billing.html`
* `profile.html`
* `rtl.html`
* `tables.html`
* `virtual-reality.html`

## Screenshots

> **Django Admin Theme**: `Edit users`

![Argon Dashboard, Users Page - Django Template generated by AppSeed.](https://user-images.githubusercontent.com/51070104/201162283-90fb0637-687e-4926-ab12-bf409491dac6.jpg)

> **Django Admin Theme**: `Dashboard` page

![Argon Dashboard, Charts & Widgets - Django Template generated by AppSeed.](https://user-images.githubusercontent.com/51070104/201162509-80df6786-e595-4fca-a570-45f6a4438c24.jpg)

***

[**Django Admin Argon**](https://github.com/app-generator/django-admin-argon-dashboard) - Modern Admin Interface provided by [**AppSeed**](https://appseed.us/)