- Notifications
You must be signed in to change notification settings - Fork1
Django Dashboard - Star Admin Black PRO | AppSeed
License
app-generator/django-star-admin-black
Folders and files
Name | Name | Last commit message | Last commit date | |
---|---|---|---|---|
Repository files navigation
Django Dashboard Star Admin Black
Admin dashboard generated by AppSeed inDjango Framework.
Designed based on the Bootstrap framework,Star Admin Black is a powerful, feature-rich, and super flexible admin dashboard template. It serves as the perfect starting point for both simple and complex web development projects. It features a well-designed dashboard with several neatly arranged components and essential elements.
Features
- SQLite Database, Django Native ORM
- Modular design, clean codebase
- Session-Based Authentication, Forms validation
- Deployment scripts: Docker, Gunicorn / Nginx
- Support viaGithub (issues tracker) andDiscord.
Links
- Django Star Admin Black - product page
- Django Star Admin Black Demo - LIVE App
$# Get the code$ git clone https://github.com/app-generator/priv-django-star-admin-black.git$cd priv-django-star-admin-black$$# Virtualenv modules installation (Unix based systems)$ virtualenv env$source env/bin/activate$$# Virtualenv modules installation (Windows based systems)$# virtualenv env$# .\env\Scripts\activate$$# Install modules - SQLite Storage$ pip3 install -r requirements.txt$$# Create tables$ python manage.py makemigrations$ python manage.py migrate$$# Start the application (development mode)$ python manage.py runserver# default port 8000$$# Start the app - custom port$# python manage.py runserver 0.0.0.0:<your_port>$$# Access the web app in browser: http://127.0.0.1:8000/
Note: To use the app, please access the registration page and create a new user. After authentication, the app will unlock the private pages.
The project is coded using a simple and intuitive structure presented bellow:
< PROJECT ROOT>||-- core/# Implements app logic and serve the static assets||-- settings.py# Django app bootstrapper||-- wsgi.py# Start the app in production||-- urls.py# Define URLs served by all apps/nodes||||-- static/|||--<css, JS, images># CSS files, Javascripts files||||-- templates/# Templates used to render pages||||-- includes/# HTML chunks and components|||-- navigation.html# Top menu component|||-- sidebar.html# Sidebar component|||-- footer.html# App Footer|||-- scripts.html# Scripts common to all pages||||-- layouts/# Master pages|||-- base-fullscreen.html# Used by Authentication pages|||-- base.html# Used by common pages||||-- accounts/# Authentication pages|||-- login.html# Login page|||-- register.html# Register page||| index.html# The default page| page-404.html# Error 404 page| page-500.html# Error 404 page|*.html# All other HTML pages||-- authentication/# Handles auth routes (login and register)||||-- urls.py# Define authentication routes||-- views.py# Handles login and registration||-- forms.py# Define auth forms||-- app/# A simple app that serve HTML files||||-- views.py# Serve HTML pages for authenticated users||-- urls.py# Define some super simple routes||-- requirements.txt# Development modules - SQLite storage||-- .env# Inject Configuration via Environment|-- manage.py# Start the app - Django default start script||--************************************************************************
The bootstrap flow
- Django bootstrapper
manage.py
usescore/settings.py
as the main configuration file core/settings.py
loads the app magic from.env
file- Redirect the guest users to Login page
- Unlock the pages served byapp node for authenticated users
The app is provided with a basic configuration to be executed inDocker,Gunicorn, andWaitress.
Docker execution
The application can be easily executed in a docker container. The steps:
Get the code
$ git clone https://github.com/app-generator/priv-django-star-admin-black.git$cd priv-django-star-admin-black
Start the app in Docker
$ sudo docker-compose pull&& sudo docker-compose build&& sudo docker-compose up -d
Visithttp://localhost:5005
in your browser. The app should be up & running.
Gunicorn 'Green Unicorn' is a Python WSGI HTTP Server for UNIX.
Install using pip
$ pip install gunicorn
Start the app using gunicorn binary
$ gunicorn --bind=0.0.0.0:8001 core.wsgi:applicationServing on http://localhost:8001
Visithttp://localhost:8001
in your browser. The app should be up & running.
Waitress (Gunicorn equivalent for Windows) is meant to be a production-quality pure-Python WSGI server with very acceptable performance. It has no dependencies except ones that live in the Python standard library.
Install using pip
$ pip install waitress
Start the app usingwaitress-serve
$ waitress-serve --port=8001 core.wsgi:applicationServing on http://localhost:8001
Visithttp://localhost:8001
in your browser. The app should be up & running.
- Django - The official website
- Boilerplate Code - Index provided byAppSeed
- Boilerplate Code - Index published on Github
Django Dashboard Star Admin Black - Provided byAppSeedApp Generator.
About
Django Dashboard - Star Admin Black PRO | AppSeed
Topics
Resources
License
Uh oh!
There was an error while loading.Please reload this page.