An iOS + web app for tracking mini golf games: create a course, add any number of players, enter scores hole-by-hole, and celebrate the winner. Works offline during a round; wins persist per player across games.
- iOS: App Store — v1.1 (approved first review)
- Web app: minigolfscoretracker.com
- API:
api.minigolfscoretracker.com(Flask on Render, Turso for storage)
| Layer | Tech |
|---|---|
| iOS wrapper | Capacitor 7 |
| Web app | React 18 + Vite (ui/) |
| Marketing site | Next.js 15 (app-view/) → Netlify |
| API | Flask + gunicorn (gthread, 4 threads) on Render (api/) |
| Auth | JWT (PyJWT) |
| Database | Turso (libsql) |
| Monetization | Google AdMob + SKAdNetwork |
api/ Flask API + database access layer (Turso in prod, sqlite3 in dev)
ui/ React + Vite web app; also the Capacitor iOS project (ui/ios/)
app-view/ Next.js marketing site → minigolfscoretracker.com
app-ads.txt AdMob authorized-sellers file (served from the marketing site)
API (SQLite fallback, no Turso credentials required):
cd api
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
python wsgi.py # or: gunicorn wsgi:appWeb app:
cd ui
npm install
npm run dev # http://localhost:5173Marketing site:
cd app-view
npm install
npm run dev # http://localhost:3000iOS simulator (from ui/):
npm run build && npx cap sync ios
open ios/App/App.xcworkspace
# ⌘R in Xcode with a simulator selectedapi/deploys to Render on push tomain. Thewsgi.pyentry point is what gunicorn boots;Procfile/ Render dashboard sets-k gthread -w 1 --threads 4 --timeout 120. Turso credentials live in Render env vars (TURSO_DATABASE_URL,TURSO_AUTH_TOKEN) — when they're absent, the API falls back to a local sqlite file so dev keeps working.ui/builds via Netlify → served atminigolfscoretracker.comand bundled into the Capacitor iOS build.app-view/(marketing) builds via Netlify → also served atminigolfscoretracker.comroot routes.- iOS releases are cut from
ui/ios/Appin Xcode, uploaded to App Store Connect, and submitted for review.
MIT.


