How thetechwrangler/social-site works
Social Site is a chronological, user-controlled social platform. People use its React interface to sign in, publish and interact with posts, follow people, join groups, discover games, message, and browse external-world content; administrators moderate accounts and reports. The browser API client connects those experiences to Express route modules and SQLite-backed services. The README documents the principal capabilities, while source excerpts show server initialization, authentication, feed/API behavior, and selected service dependencies; several feature-specific internals are not sampled, so their detailed links are omitted.
Main entry points: auth.ts Authentication · index.ts Express API · database.ts SQLite database · client.ts API client
Components 24
Web experience
- React application
src/App.tsx - API client
src/api/client.ts - Home feed
src/pages/HomePage.tsx - Profiles
src/pages/ProfilePage.tsx - Admin console
src/pages/AdminPage.tsx - Post card
src/components/PostCard.tsx
API and identity
- Express API
server/index.ts - Authentication
server/routes/auth.ts - OAuth providers
server/authProviders.ts - Access middleware
server/middleware.ts
Social features
- Feed endpoints
server/routes/feed.ts - Posts and comments
server/routes/posts.ts - Groups
server/routes/groups.ts - Direct messages
server/routes/messages.ts - Moderation
server/routes/admin.ts
Discovery and media
- Games and LFG
server/routes/games.ts - RSS and world feed
server/rssService.ts - External content
server/externalContentService.ts - YouTube integration
server/youtubeService.ts
Persistence and operations
- SQLite database
server/database.ts - Auth event logging
server/authEvents.ts - Email delivery
server/email.ts - Safe diagnostics
server/safeDiagnostics.ts
Other components
- Person
Connections 26
- Person → React application: uses
README.md - React application → API client: requests through
src/App.tsx - Express API → SQLite database: initializes
server/index.ts - Express API → Authentication: mounts
server/index.ts - Express API → Feed endpoints: mounts
server/index.ts - Express API → Moderation: mounts
server/index.ts - Express API → OAuth providers: configures
server/index.ts - Authentication → SQLite database: reads and writes
server/routes/auth.ts - Authentication → Auth event logging: records events
server/routes/auth.ts - Authentication → Email delivery: sends mail
server/routes/auth.ts - Authentication → Safe diagnostics: logs failures
server/routes/auth.ts - OAuth providers → SQLite database: uses
server/authProviders.ts - OAuth providers → Auth event logging: uses
server/authProviders.ts - OAuth providers → Safe diagnostics: logs failures
server/authProviders.ts - Access middleware → Authentication: authenticates requests
server/middleware.ts - Moderation → SQLite database: reads and writes
server/routes/admin.ts - Moderation → Access middleware: guards operations
server/routes/admin.ts - Moderation → Auth event logging: records actions
server/routes/admin.ts - API client → Feed endpoints: requests feed
src/api/client.ts - RSS and world feed → SQLite database: reads and writes
server/rssService.ts - RSS and world feed → External content: uses service
server/rssService.ts - RSS and world feed → YouTube integration: uses service
server/rssService.ts - External content → SQLite database: reads and writes
server/externalContentService.ts - Post card → API client: loads interactions
src/components/PostCard.tsx - Profiles → API client: loads profile
src/pages/ProfilePage.tsx - Admin console → API client: requests admin data
src/pages/AdminPage.tsx