Chapter 01
Product overview
Making local sport easier to find, join, and return to.
PeerFit brings casual athletes and fitness enthusiasts into one place to discover nearby activities, create structured events, and participate with confidence. It addresses the fragmentation of grassroots sport: finding the right people, keeping commitments, and building trust after the game is over.
Chapter 02
Core experience
A participation loop designed around location, trust, and momentum.
The product begins with an accessible sign-in flow, then gives members a dashboard for events, workouts, streaks, achievements, and leaderboards. From there they can discover communities, filter local activities by sport, skill level, intensity, date, and rating, or host an event through a guided five-step flow.
“Discovery becomes a reliable community when every event has structure, accountability, and a reason to come back.”
Chapter 03
Architecture
One product system across mobile, API, and data layers.
-
01
Mobile client
React Native with Expo SDK 53, expo-router, Context API, device location, Leaflet maps inside a WebView, and i18n for English, French, and Arabic.
-
02
Application services
Node.js and Express expose the REST API; Socket.IO provides event-room chat. JWT and bcrypt protect accounts while express-validator sanitises API inputs.
-
03
Event automation
Background schedulers move events through upcoming, in-progress, and completed states, then unlock ratings, evaluate achievements, and trigger reminders.
-
04
Data & safety
PostgreSQL and Sequelize manage 15+ models for users, events, ratings, achievements, activity, reminders, blocks, reports, and suspensions, with indexes for date and location queries.
Chapter 04
Outcome
A production-ready foundation that can grow with the community.
The cross-platform mobile app is built for Android and iOS, with discovery, event management, reputation, moderation, notifications, and engagement systems connected. The architecture is prepared for future scaling with queue-based jobs, Redis, PostGIS, and horizontally scaled real-time services.
-
15+
Domain models
-
4
Rating criteria
-
3
Supported languages