Spin the Activity

A colorful web app that spins a wheel to pick an activity. Lists live in PostgreSQL. Visitors spin public lists and hidden lists they have a link to; an account saves private lists, copies, progress, and history.

A GeekyNuggets.com app. MIT License.

Forge: ai-collab/spin-the-activity.

Features

• Click or tap the wheel to spin; starburst on the click, confetti on the landing, pulsing winner overlay
• Library of built-in lists plus personal lists
• Slice name, icon, color, wait time, and enabled — name or icon required
• Four list modes: full random, use wait times, disable once chosen, cycle then restart
• Email and password accounts with a display name; email used for confirmation and recovery
• Copy lists, public/hidden/private visibility, per-list spin history, and a personal stats dashboard
• Account data download and self-service account deletion
• Help, Privacy Policy, and Terms of Service on the site
• Administrator console for accounts, lists, configuration, operator details, and usage
• App container plus a dedicated Postgres container

Run with Docker

docker compose up --build

Open http://localhost:8080/. Details: DOCKER_README.md.

Published hosts and the dev → main cadence: docs/PROMOTION.md.

Run on the host

Python 3.12+:

python3 -m venv .venv
. .venv/bin/activate
pip install -e ".[dev]"
python -m spin_the_activity

The server binds 0.0.0.0:8080. Set STA_DATABASE_URL to a Postgres database. ./data/ holds the cookie-signing secret when STA_SECRET_KEY is unset.

pytest

Documentation

File	Role
docs/DESIGN.md	Product rules
docs/TECHNICAL.md	Schema, HTTP, layout
docs/USER_GUIDE.md	Visitor help (also /help)
docs/VERSIONING.md	Version policy
docs/ATTRIBUTIONS.md	Fonts and art
DOCKER_README.md	Container usage
docs/PROMOTION.md	Preview/prod hosts and cadence

Versioning is beta. Canonical file: VERSION. Display form may add a v prefix; the file does not.