How ctrl-freaks26/skillswap works
SkillSwap is a peer-to-peer skill-exchange product, with a React web client, an Expo mobile shell, and an Express REST API. The visible web journey runs from landing and account access through onboarding to a dashboard; the API currently implements registration, login, logout, and the current-user endpoint. Matching, swap sessions, and communication are documented product areas but remain API stubs. Edges reflect shown routing and calls or README statements; unsampled implementations and client-to-API request flows are not inferred.
Main entry points: App.tsx Web route shell · routes.ts Versioned API routes · app.ts HTTP application · RegisterPage.tsx Registration
Components 22
Web experience
- Web route shell
apps/web/src/App.tsx - Landing page
apps/web/src/pages/LandingPage.tsx - Registration
apps/web/src/pages/RegisterPage.tsx - Login
apps/web/src/pages/LoginPage.tsx - Skill onboarding
apps/web/src/pages/OnboardingPage.tsx - Dashboard
apps/web/src/pages/DashboardPage.tsx - Signed-in shell
apps/web/src/components/AppShell.tsx - Auth branding
apps/web/src/components/AuthAside.tsx
Mobile client
- Mobile app shell
apps/mobile/App.tsx - Shared types
packages/shared/src/index.ts
API runtime
- HTTP application
apps/api/src/app.ts - Versioned API routes
apps/api/src/routes.ts - Runtime configuration
apps/api/src/config/env.ts - Postgres persistence
apps/api/src/common/db/prisma.ts - Redis sessions
apps/api/src/common/redis/redis.ts
Identity
- Identity routes
apps/api/src/modules/identity/identity.routes.ts - Identity controller
apps/api/src/modules/identity/identity.controller.ts - Identity service
apps/api/src/modules/identity/identity.service.ts
Exchange services
- Skill matching
apps/api/src/modules/matching - Chat and notifications
apps/api/src/modules/communication/communication.routes.ts - Swap sessions
apps/api/src/modules/sessions/sessions.routes.ts
Other components
- Student or staff
Connections 23
- Student or staff → Web route shell: uses
- Web route shell → Landing page: routes to
apps/web/src/App.tsx - Web route shell → Registration: routes to
apps/web/src/App.tsx - Web route shell → Login: routes to
apps/web/src/App.tsx - Web route shell → Skill onboarding: routes to
apps/web/src/App.tsx - Web route shell → Dashboard: routes to
apps/web/src/App.tsx - Web route shell → Signed-in shell: wraps signed-in pages
apps/web/src/App.tsx - Registration → Auth branding: renders
apps/web/src/pages/RegisterPage.tsx - Login → Auth branding: renders
apps/web/src/pages/LoginPage.tsx - Mobile app shell → Shared types: uses skill levels
apps/mobile/App.tsx - HTTP application → Versioned API routes: mounts API routes
apps/api/src/app.ts - Versioned API routes → Identity routes: mounts auth routes
apps/api/src/routes.ts - Versioned API routes → Skill matching: mounts matches routes
apps/api/src/routes.ts - Versioned API routes → Chat and notifications: mounts conversations routes
apps/api/src/routes.ts - Versioned API routes → Swap sessions: mounts swap routes
apps/api/src/routes.ts - HTTP application → Redis sessions: stores sessions
apps/api/src/app.ts - HTTP application → Runtime configuration: reads settings
apps/api/src/app.ts - Identity routes → Identity controller: dispatches handlers
apps/api/src/modules/identity/identity.routes.ts - Identity controller → Identity service: calls
apps/api/src/modules/identity/identity.controller.ts - Identity service → Postgres persistence: accesses database
apps/api/src/modules/identity/identity.service.ts - Skill matching → Student or staff: supports skill discovery
README.md - Chat and notifications → Student or staff: supports chat and alerts
apps/api/src/modules/communication/communication.routes.ts - Swap sessions → Student or staff: supports skill swaps
README.md