FreeGameHub

Production-ready game catalog for free Windows and Mac ARM downloads, backed by a Flask API and persistent server-side JSON database.

Run locally

.env/bin/python -m flask --app src/main run --host 127.0.0.1 --port 5000 --debug --no-reload

Open http://127.0.0.1:5000.

The admin catalog is stored in data/freegamehub.json locally. On Wasmer, app.yaml mounts a persistent /data volume so uploaded games are shared by every visitor and survive redeploys.

Deploy to Wasmer

From this freegamehub directory:

wasmer login
wasmer run .
wasmer deploy

Wasmer runs the Flask app from src/main.py. The frontend fetches games from /api/games, so other devices see the admin-added catalog.

Admin

Open /#/admin and use the owner passcode: vir@1517.

The admin panel supports title, genre, descriptions, tags, Windows download link, Mac ARM download link, cover image URL, local cover image upload, and catalog import/export. If no cover is provided, the site generates a polished placeholder automatically.