flask-template Flask · Python 3

Mindfree Automated Delivery System

Deployment live — this environment was deployed automatically on push.
Project
flask-template
Branch
main
Commit
75b4c01
Status
● Live

Database

✓ Database connected — showing last deploy_log records.
#ProjectBranchCommitDeployed at (UTC)
4flask-templatemain75b4c012026-07-10 12:47:07.487797
3flask-templatemain357418b2026-07-10 12:31:15.815425
2flask-templatemainc17f5ed2026-07-01 09:16:48.843707
1flask-templatemaindcdcd152026-06-18 09:51:02.756416

How to use this template

1
Create a new repo from this template

On GitHub, click "Use this template""Create a new repository". Set the owner to Mindfree-2 and make the repo private — the self-hosted runner only works on private repositories.

2
Push to deploy

Every push to any branch triggers the CI/CD pipeline automatically within ~2 minutes. Each branch gets its own isolated URL:

  • main{project}.mindfree.info
  • staging{project}.staging.mindfree.info
  • any other branch → {branch}.{project}.dev.mindfree.info
3
Write your code

Add routes in app/routes.py. For larger apps, create additional Blueprint files and register them in app/__init__.py. Static files go in app/static/, Jinja2 templates in app/templates/.

4
Add secrets & environment variables

Go to your repo → Settings → Secrets and variables → Actions. Secrets are injected as environment variables at deploy time and available to your app at runtime via os.getenv().

Available Endpoints

RouteDescription
GET /This welcome page — replace with your application’s home
GET /healthHealth check — returns ok, used by the deploy script to confirm the app is up

Project Structure

flask-template/
├── app/
│   ├── __init__.py       ← app factory, db & migrate setup
│   ├── models.py         ← SQLAlchemy models (add yours here)
│   └── routes.py         ← add your routes here
├── migrations/           ← Alembic migrations (commit this folder)
├── requirements.txt      ← Python dependencies
├── gunicorn.conf.py      ← Gunicorn server config (socket, workers)
└── Dockerfile            ← container build (runs migrations on start)