How naitik2004/showup.v2 works
ShowUp is a pickup-sports coordination app. Players discover nearby games, host or join within capacity, coordinate in member-only chat, then complete matches and rate participants. The map/browse, match lifecycle, and ratings form the main workflow; social connections, partner discovery, clubs, moderation, account security, and notifications are substantial supporting capabilities. The README documents these relationships; sampled source excerpts are partial, so unsampled internal call paths are not inferred.
Main entry points: [id]/page.tsx Match workspace · index.ts API server · browse/page.tsx Map and browse · prisma.ts PostgreSQL
Components 22
Game discovery
- Map and browse
apps/web/app/browse/page.tsx - Match discovery
apps/api/src/routes/matches.ts
Match coordination
- Host match
apps/web/app/new/page.tsx - Match management
apps/api/src/routes/matches.ts - Join and approvals
apps/api/src/routes/membership.ts - Match workspace
apps/web/app/matches/[id]/page.tsx - Realtime match chat
apps/api/src/routes/chat.ts - Socket.IO
apps/api/src/realtime.ts - Match lifecycle
apps/api/src/lib/lifecycle.ts - Ratings and reputation
apps/api/src/routes/ratings.ts
Player community
- Friends and invites
apps/api/src/routes/friends.ts - Clubs and fixtures
apps/api/src/routes/clubs.ts - Partner discovery
apps/api/src/routes/partners.ts - Partner experience
apps/web/app/partners/page.tsx
Accounts and operations
- Authentication
apps/api/src/routes/auth.ts - Google sign-in
apps/api/src/routes/googleAuth.ts - Notifications
apps/api/src/lib/notificationWorker.ts - Moderation and appeals
apps/api/src/routes/admin.ts - Service operations
apps/api/src/lib/operations.ts - PostgreSQL
apps/api/src/prisma.ts - API server
apps/api/src/index.ts
Other components
- Player
Connections 24
- Player → Map and browse: finds games
README.md - Map and browse → Match discovery: requests matches
README.md - Player → Host match: hosts game
README.md - Host match → Match management: creates match
README.md - Map and browse → Match workspace: opens match
README.md - Match workspace → Join and approvals: requests to join
README.md - Join and approvals → PostgreSQL: reserves capacity
README.md - Match workspace → Realtime match chat: uses member chat
README.md - Realtime match chat → Socket.IO: communicates live
README.md - Match workspace → Match lifecycle: starts or finishes
README.md - Match workspace → Ratings and reputation: rates participants
README.md - Ratings and reputation → PostgreSQL: stores ratings
README.md - Player → Friends and invites: connects and invites
README.md - Player → Partner experience: discovers partners
README.md - Partner experience → Partner discovery: requests discovery
apps/web/app/partners/page.tsx - Player → Clubs and fixtures: uses clubs
README.md - Player → Authentication: signs in
README.md - Player → Google sign-in: signs in with Google
README.md - API server → PostgreSQL: uses Prisma
apps/api/src/index.ts - API server → Notifications: starts worker
apps/api/src/index.ts - API server → Authentication: mounts routes
apps/api/src/index.ts - API server → Google sign-in: mounts routes
apps/api/src/index.ts - Player → Moderation and appeals: reports issues
README.md - Player → Service operations: owner monitors
README.md