About this project

base-flask is a base Flask/Gunicorn/nginx setup intended as a skeleton for building simple web applications. It targets Python 3 and is designed for websites rather than pure JSON APIs. The repository provides a minimal but current dependency set, documented setup and usage procedures, and a production-oriented configuration for secure and fast serving with nginx and Gunicorn. It includes Docker support, a scaffold script to create a project copy, and host setup and deployment scripts. The project is oriented toward small virtual machines on Ubuntu or Debian, with optional CDN integration such as Cloudflare for encrypted delivery. Development workflows use venv, direnv, pnpm, Ruff, mypy, shellcheck, unittest coverage, and pnpm tests. The README also shows a CI/CD flow using pyenv, linting, testing, coverage, and SSH deployment, as well as commands for building and running a Docker container.