← Back to FitQuest

FitQuest — App Info

Sitemap, wireframes, architecture overview, and tech stack for the gamified fitness PWA.

Sitemap Structure

🌐 fitquest.app public
- 🔐 / — Login & Register public
- 📊 /dashboard — Overview auth
  - 📈 XP + Level progress
  - 🏃 Recent workouts
  - 📉 Calorie macro ring
  - 🏆 Badge showcase
- 💪 /workout — Workouts auth
  - 📋 Daily steps info card (Health Connect)
  - ➕ Log workout (modal)
  - 🔄 Sync Health Connect / Fitbit
  - 🗂️ Workout history list
- 🥗 /diet — Nutrition auth
  - 📊 Macro ring summary
  - ➕ Log meal (modal)
  - 📆 Daily meal log
- 🎯 /goals — Habits & Goals auth
  - 🔥 Streak banner
  - ✅ Daily habits (auto-tracked)
  - 🏅 Long-term goals
- 🏅 /badges — Achievements auth
- 🏆 /leaderboard — Rankings auth
- ⚙️ /settings — Account auth
- 🛡️ /admin — Admin Panel admin
  - 👥 User management
  - 📧 Email templates
  - 📊 Platform stats
- ℹ️ /info.html — App Info public
- 📡 /telemetry.html — Analytics public
- 📖 /about.html — About public

API Endpoints Backend

⚡ /api REST
- /api/auth — Login, register, reset password
- /api/user — Profile, XP, streak
- /api/workouts — CRUD workout logs
- /api/diet — CRUD meal logs
- /api/goals — Long-term goals CRUD
- /api/habits — Daily habits + completions
- /api/badges — Earned badges list
- /api/health-connect — Webhook ingest + daily stats
- /api/fitbit — OAuth2 + data sync
- /api/google — Google OAuth2 flow
- /api/families — Family groups + challenges
- /api/admin — Admin-only management
- /api/analytics — Telemetry tracking + public stats
- /v1 — Public API (no auth)

Wireframes UI Layout

9:41●●●

Dashboard

Mobile — Dashboard (375px)

Desktop — Dashboard (≥768px)

Data Flow Architecture

How data moves through the system:

Manual entry

Browser (PWA)

→

Express /api/workouts

→

PostgreSQL workouts

→

Gamification service

→

XP / Level / Badges

Health Connect webhook

Android HC Webhook

→

POST /api/health-connect/webhook

→

health_daily_stats + workouts

→

Steps card + Workouts

Habits & streaks

Goals page load

→

GET /api/habits

→

Query workouts + health_daily_stats

→

Auto-progress bars + streak

Telemetry

navigator.sendBeacon

→

POST /api/analytics/track

→

analytics_events (no PII)

→

telemetry.html

Tech Stack Implementation

Layer	Technology	Purpose
Frontend	Vanilla JS (ES2022) + PWA	SPA with service worker, offline support, install prompt
Frontend	Material Symbols Rounded	Icon library (Google CDN, variable font)
Frontend	Web Audio API	Synthesized UI sounds (no audio files)
Backend	Node.js + Express 4	REST API server
Backend	PostgreSQL 16	Primary database — users, workouts, diet, habits, analytics
Backend	Redis 7	Session storage, rate-limit counters, caching
Backend	bcrypt + JWT	Password hashing + stateless auth tokens
Infra	Docker Compose	Local + production orchestration (app, postgres, redis)
Infra	Nginx	Reverse proxy, TLS termination, static caching
Integrations	Google Health Connect	Android webhook for passive step/workout data
Integrations	Fitbit OAuth2	Workout + sleep data import

View live telemetry → | About FitQuest → | Back to app →