Django Suit Dashboard

Create a dashboard within Django admin interface.

This application was originally designed to work within Django Suit (hence the name), but it is now decoupled from it, you can use it without Suit.

Here is a quick explanation of how it works:

• you write a base template to add CSS/JavaScript libraries (optional)
• you write a custom AdminSite to override default URLs and/or add others
• you write the corresponding views, inheriting from DashboardView
• each view render the base template (or an extended one) with a grid in the context (layout of rows and columns)
• columns can contain boxes of content (visual separation on the page)
• boxes can contain widgets, for which you write the HTML/CSS/JS

So basically django-suit-dashboard does not do much, it just provides a way to create a dashboard in admin interface without touching too much to HTML (which not everyone will approve).

Screenshot

License

Software licensed under ISC license.

Installation

pip install django-suit-dashboard

Documentation

On ReadTheDocs

Demo project

Follow these instructions to run the demo locally:

git clone https://github.com/Pawamoy/suit-dashboard-demo
cd suit-dashboard-demo
./install.sh
^C (Ctrl-c)
./run.sh [with-suit]  # any non-empty arg will do

Connect to the admin interface with your system username and password admin_password.

Don't hesitate to send me Pull Requests to share your boxes and widgets, I will add them into the demo pages!

Applications using Suit-Dashboard

Here is a list of Django Apps using Suit-Dashboard. You might find some interesting ways of using it.

• django-cerberus-ac: role-based access control for Django (early development)
• django-meerkat: security audit application for Django sites (work in progress)

Development

To run all the tests: tox