How japegomez/jugamus works
jugaMUS is a cross-platform mus community app for finding opponents and organizing matches, tournaments, and leagues; it does not implement the mus game itself. The main workflow is to discover or create an event, coordinate participation, record and validate results, and view standings or player statistics. Routes and React Query hooks form the client-facing layer; domain services use Supabase for backend operations. The README documents additional moderation, analytics, notifications, and guest scoreboard capabilities. Some feature modules were not sampled, so their internal wiring is left unspecified.
Main entry points: supabase.ts Supabase backend · matches.service.ts Match coordination · app App routes · useAuth.ts Authentication
Components 20
App and identity
- App routes
src/app - Authentication
src/hooks/useAuth.ts - Auth storage
src/lib/authStorage.ts
Matches and play
- Discover events
src/app/(tabs)/explore/index.tsx - Match queries
src/hooks/useMatches.ts - Match coordination
src/services/matches.service.ts - Result validation
src/services/results.service.ts - Live scoreboard
src/hooks/useLiveScoreboard.ts - Scoreboard view
src/components/matches/ScoreboardBoard.tsx - Guest scoreboard
src/app/(auth)/guest-scoreboard
Leagues and community
- Tournament management
src/services/tournaments.service.ts - League management
src/services/leagues.service.ts - Friend connections
src/hooks/useFriends.ts - Profiles
src/services/profiles.service.ts - Player statistics
src/services/stats.service.ts
Backend and insights
- Moderation and reports
src/services/admin.service.ts - Push notifications
supabase/functions/process-notifications/index.ts - Product analytics
src/lib/analytics.ts - Supabase backend
src/lib/supabase.ts
Other components
- Player
Connections 23
- Player → App routes: uses
README.md - App routes → Authentication: authenticates
README.md - App routes → Discover events: discovers
README.md - Discover events → Match queries: loads events
src/app/(tabs)/explore/index.tsx - Discover events → Match coordination: queries
src/app/(tabs)/explore/index.tsx - Match queries → Match coordination: calls
src/hooks/useMatches.ts - Match coordination → Result validation: maps errors
src/services/matches.service.ts - Scoreboard view → Live scoreboard: uses
src/components/matches/ScoreboardBoard.tsx - Guest scoreboard → Live scoreboard: offers access
- Match coordination → Supabase backend: reads and writes
src/services/matches.service.ts - Result validation → Supabase backend: reads and writes
src/services/results.service.ts - Tournament management → Supabase backend: reads and writes
src/services/tournaments.service.ts - League management → Supabase backend: reads and writes
src/services/leagues.service.ts - Authentication → Supabase backend: uses auth
src/hooks/useAuth.ts - Authentication → Auth storage: persists session
- Player → Tournament management: organizes tournaments
README.md - Player → League management: organizes leagues
README.md - Player → Friend connections: connects
README.md - Player → Profiles: views profiles
README.md - Player → Player statistics: views stats
README.md - Player → Moderation and reports: reports issues
README.md - Push notifications → Supabase backend: processes events
- Match coordination → Product analytics: tracks events
src/services/matches.service.ts