app-generator / flask-adminlte

AdminLTE Flask - Open-source Seed Project | AppSeed

AdminLTE Flask

Open-source Flask Dashboard generated by AppSeed on top of an iconic design. For newcomers, AdminLTE is one of the best open-source admin dashboard & control panel themes. Built on top of Bootstrap, AdminLTE provides a range of responsive, reusable, and commonly used components.

• 👉 AdminLTE Flask - product page
• 👉 AdminLTE Flask - LIVE Deployment

Features

Have questions? Contact Support (Email & Discord) provided by AppSeed

Free Version	PRO Version	Custom Development
✓ Up-to-date dependencies	Everything in Free, plus:	Everything in PRO, plus:
✓ Best Practices	✅ Premium Bootstrap 5 Design	✅ 1mo Custom Development
✓ DB: SQLite, MySql	✅ PRO Support - Email & Discord	✅ Team: PM, Developer, Tester
✓ DB Tools: ORM, Flask-Migrate	✅ Private REPO Access	✅ Weekly Sprints
✓ Session-Based authentication	-	✅ Technical SPECS
✓ Docker	-	✅ Documentation
✓ CI/CD Flow via Render	-	✅ 30 days Delivery Warranty
✓ Free Support	-	-
---------------------------------	---------------------------------	---------------------------------
✓ LIVE Demo	🚀 LIVE Demo PRO	🛒 Order: $4,999 (GUMROAD)

✅ Start in Docker

👉 Step 1 - Download the code from the GH repository (using GIT)

$ git clone https://github.com/app-generator/flask-adminlte.git
$ cd flask-adminlte

👉 Step 2 - Start the APP in Docker

$ docker-compose up --build 

Visit http://localhost:5085 in your browser. The app should be up & running.

✅ Manual Build

Download the code

$ git clone https://github.com/app-generator/flask-adminlte.git
$ cd flask-adminlte

👉 Set Up for Unix, MacOS

Install modules via VENV

$ virtualenv env
$ source env/bin/activate
$ pip3 install -r requirements.txt

Set Up Flask Environment

$ export FLASK_APP=run.py
$ export FLASK_ENV=development

Start the app

$ flask run

At this point, the app runs at http://127.0.0.1:5000/.

👉 Set Up for Windows

Install modules via VENV (windows)

$ virtualenv env
$ .\env\Scripts\activate
$ pip3 install -r requirements.txt

Set Up Flask Environment

$ # CMD 
$ set FLASK_APP=run.py
$ set FLASK_ENV=development
$
$ # Powershell
$ $env:FLASK_APP = ".\run.py"
$ $env:FLASK_ENV = "development"

Start the app

$ flask run

At this point, the app runs at http://127.0.0.1:5000/.

👉 Create Users

By default, the app redirects guest users to authenticate. In order to access the private pages, follow this set up:

• Start the app via flask run
• Access the registration page and create a new user:
  • http://127.0.0.1:5000/register
• Access the sign in page and authenticate
  • http://127.0.0.1:5000/login

✅ Codebase

The project is coded using blueprints, app factory pattern, dual configuration profile (development and production) and an intuitive structure presented bellow:

< PROJECT ROOT >
   |
   |-- apps/
   |    |
   |    |-- home/                           # A simple app that serve HTML files
   |    |    |-- routes.py                  # Define app routes
   |    |
   |    |-- authentication/                 # Handles auth routes (login and register)
   |    |    |-- routes.py                  # Define authentication routes  
   |    |    |-- models.py                  # Defines models  
   |    |    |-- forms.py                   # Define auth forms (login and register) 
   |    |
   |    |-- 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
   |    |    |
   |    |    |-- home/                      # UI Kit Pages
   |    |         |-- index.html            # Index page
   |    |         |-- 404-page.html         # 404 page
   |    |         |-- *.html                # All other pages
   |    |    
   |  config.py                             # Set up the app
   |    __init__.py                         # Initialize the app
   |
   |-- requirements.txt                     # App Dependencies
   |
   |-- .env                                 # Inject Configuration via Environment
   |-- run.py                               # Start the app - WSGI gateway
   |
   |-- ************************************************************************

✅ PRO Version

For more components, pages, and priority on support, feel free to take a look at this amazing starter:

Flask starter styled with Material Dashboard PRO, a premium Bootstrap 5 KIT from Creative-Tim. The product is designed to deliver the best possible user experience with highly customizable feature-rich pages.

• 👉 Flask Material 2 PRO - Product page
• 👉 Flask Material 2 PRO - LIVE Demo

---

AdminLTE Flask - Open-source starter generated by App Generator.

flask-adminlte's Issues

SQL Server integration?

Hi!
This project is amazing, thanks!

Could this be compatible with ms-sqlserver? what strategy do you suggest?

Thanks!

A secret key is required to use CSRF

Hi!

I'm getting this error:

File "/home/fernandogarcia/Downloads/flask-dashboard-adminlte/env/lib/python3.6/site-packages/flask_wtf/csrf.py", line 128, in _get_config
    raise RuntimeError(message)
RuntimeError: A secret key is required to use CSRF

Looks like this piece of code is not being used or CSRF key is something else.

SECRET_KEY = config('SECRET_KEY', default='S#perS3crEt_007')

The server is always returning HTTP 500.

Can you help me please?

Best regards.

flask.cli.NoAppException : ImportError: No module named flask_minify

Hello Team,
I'm getting an error when trying to open the webpage in the 'development' environment.

'''
flask.cli.NoAppException
NoAppException: While importing "run", an ImportError was raised:

Traceback (most recent call last):
File "/usr/local/lib/python2.7/dist-packages/flask/cli.py", line 240, in locate_app
import(module_name)
File "/root/MechanicWala/run.py", line 8, in
from flask_minify import Minify
ImportError: No module named flask_minify
'''

Enhancement - Flask MongoDB Integration

Hi, thank you for this template, I am new to flask and I find it confusing on how the app config is setup, I am trying to add mongodb to my app but having a hard time sending the config URI via PyMyngo

app.config["MONGO_URI"] = "mongodb://uv-mongodb:27017/platform")
mongo = PyMongo(app)

I'm getting the following error:
AttributeError: module 'app' has no attribute 'config'
I'm struggling to send the uri to PyMongo, i've tried as a positional argument but still failing.
Any help is apprecisated.

Flask Migrate Error

I followed the README steps precisely and installed the packages inside my virtual environment. When I try to run flask I get the following error:

   from   flask_migrate import Migrate
ModuleNotFoundError: No module named 'flask_migrate'

Here are the pip packages I am using within the virtual environment:

Package          Version
---------------- -------
alembic          1.7.7
aniso8601        9.0.1
attrs            21.4.0
click            8.1.3
dnspython        2.2.1
email-validator  1.1.3
Flask            2.0.2
Flask-Login      0.5.0
Flask-Migrate    3.1.0
Flask-Minify     0.37
Flask-MySQLdb    1.0.1
flask-restx      0.5.1
Flask-SQLAlchemy 2.5.1
Flask-WTF        1.0.0
greenlet         1.1.2
gunicorn         20.1.0
htmlmin          0.1.12
idna             3.3
itsdangerous     2.1.2
Jinja2           3.0.2
jsmin            3.0.1
jsonschema       4.5.1
lesscpy          0.15.0
Mako             1.2.0
MarkupSafe       2.1.1
mysqlclient      2.1.0
pip              22.0.4
ply              3.11
pyrsistent       0.18.1
python-dotenv    0.19.2
pytz             2022.1
rcssmin          1.1.0
setuptools       62.1.0
six              1.16.0
SQLAlchemy       1.4.29
Werkzeug         2.0.3
wheel            0.37.1
WTForms          3.0.0
xxhash           3.0.0