flask-app-blueprint

Open source MIT Python

GitHub

221

Stars

Forks

Issues

Watchers

4 weeks

Last Commit

Frontend Templates Developer Tools

About flask-app-blueprint

Flask App Blueprint is a comprehensive starter project for Python Flask 3 applications designed to accelerate Minimum Viable Product development. It provides a robust foundation featuring user authentication with email confirmation and password reset, user profiles, and a dedicated admin section for statistics and user management. The framework supports both public and member-only pages alongside full database Create, Read, Update, and Delete operations. It is engineered for flexibility, supporting local development with SQLite, optional PostgreSQL integration, and seamless deployment to Heroku. The project includes a pre-configured development environment for GitHub Codespaces, database migration tools, transactional email hooks, and a verified unit test suite using Python's built-in unittest framework. The tech stack combines a Python back-end with a Bootstrap 5.3 front-end. Installation and setup are streamlined through the uv package manager, requiring environment variable configuration and a single comma

Platforms

Web Self-hosted

Languages

Python

Links

Source Code

Published by

jelmerdejong

Visit View Profile

README.md

View on GitHub

Flask App Blueprint: the fast way to start your MVP

Flask App Blueprint is a small starter app for Flask 3 projects. It includes authentication, CRUD examples, database migrations, transactional email hooks, a verified unittest suite, and a workflow that works locally, in GitHub Codespaces, and on Heroku.

Features

User registration, email confirmation, and password reset via SMTP
User profiles, including change password
Admin only pages including statistics and user management
Public and member only pages
Database setup, including database migrations and CRUD examples
Local development with SQLite by default, optional PostgreSQL, and Heroku deployment support
GitHub Codespaces support through a checked-in devcontainer
Powerful stack: back-end based on Python with Flask, front-end is Bootstrap 5.3.8 with the Bootstrap bundle JS
Including basic test coverage with Python's built-in unittest framework

Quick Start

Install uv: python -m pip install uv
Sync the locked environment: uv sync --locked
Copy .env.example to .env if you want to set a real SECRET_KEY, PostgreSQL, or SMTP credentials
Apply migrations: uv run flask db upgrade
Run tests: uv run python -m unittest discover -s project/tests -v
Start the app: uv run flask run

Documentation

Find all the documentation in this repository in the docs folder.