How begleee/social-media-platform works
This is a full-stack social platform: users register or sign in, enter protected pages, browse a feed and profiles, and create or interact with posts. The client’s router and feature components lead into query hooks and an Axios service; the Express server dispatches requests to domain routes and controllers. The sampled post, auth, and user controllers show Prisma-backed operations, while README and route/index references establish additional feed, follow, like, comment, and media capabilities. Some subsystem internals were not sampled, so their links are limited to documented or indexed wiring.
Main entry points: server.js Express server · main.jsx Client router · authMiddleware.js JWT authorization · postControllers.js Post operations
Components 31
Client experience
- Client router
client/src/main.jsx - Protected pages
client/src/components/ProtectedRoute.jsx - Feed views
client/src/components/feed/FeedContent.jsx - Post views
client/src/components/post/PostCard.jsx - Profile posts
client/src/components/profile/UserPosts.jsx - Post composer
client/src/components/create_post/CreatePostForm.jsx - Query hooks
client/src/hooks/usePosts.js - HTTP client
client/src/services/api.js
Identity and access
- Auth forms
client/src/components/auth/LoginForm.jsx - Auth state
client/src/store/authStore.js - Auth routes
server/src/routes/authRoutes.js - Auth operations
server/src/controllers/authController.js - JWT authorization
server/src/middlewares/authMiddleware.js
Social content
- Social routes
server/src/routes/postRoutes.js - Post operations
server/src/controllers/postControllers.js - Feed routes
server/src/routes/feedRoutes.js - Feed operations
server/src/controllers/feedController.js - Social action routes
server/src/routes/commentRoutes.js - Comment operations
server/src/controllers/commentController.js - Follow routes
server/src/routes/followRoutes.js - Like routes
server/src/routes/likeRoutes.js
Media management
- Image routes
server/src/routes/imageRoutes.js - Upload middleware
server/src/middlewares/uploadMiddleware.js - Image operations
server/src/controllers/imageController.js - Upload utility
server/src/utils/filesUtils.js
Server and persistence
- Express server
server/src/server.js - User operations
server/src/controllers/userControllers.js - User routes
server/src/routes/userRoutes.js
Other components
- User
- Cloudinary
- PostgreSQL
Connections 41
- User → Client router: navigates
client/src/main.jsx - Client router → Protected pages: routes protected paths
client/src/main.jsx - Client router → Auth forms: routes auth pages
client/src/main.jsx - Client router → Feed views: routes feed page
client/src/main.jsx - Client router → Post composer: routes composer page
client/src/main.jsx - Client router → Post views: routes post detail
client/src/main.jsx - Client router → Profile posts: routes profile page
client/src/main.jsx - Protected pages → Auth state: checks session
client/src/components/ProtectedRoute.jsx - Post composer → Query hooks: creates posts
- Post views → Query hooks: loads post data
client/src/pages/PostDetailsPage.jsx - Query hooks → HTTP client: sends requests
client/src/hooks/usePosts.js - Auth forms → Auth state: updates session
- HTTP client → Express server: calls API
- Express server → Auth routes: mounts routes
server/src/server.js - Express server → Social routes: mounts routes
server/src/server.js - Express server → Feed routes: mounts routes
server/src/server.js - Express server → Social action routes: mounts routes
server/src/server.js - Express server → Follow routes: mounts routes
server/src/server.js - Express server → Like routes: mounts routes
server/src/server.js - Express server → Image routes: mounts routes
server/src/server.js - Express server → User routes: mounts routes
server/src/server.js - Auth routes → Auth operations: dispatches
server/src/routes/authRoutes.js - Social routes → Post operations: dispatches
server/src/routes/postRoutes.js - Social routes → JWT authorization: checks access
server/src/routes/postRoutes.js - Feed routes → Feed operations: dispatches
server/src/routes/feedRoutes.js - Social action routes → Comment operations: dispatches
server/src/routes/commentRoutes.js - Social action routes → JWT authorization: checks access
server/src/routes/commentRoutes.js - Follow routes → JWT authorization: checks access
server/src/routes/followRoutes.js - Like routes → JWT authorization: checks access
server/src/routes/likeRoutes.js - Image routes → Upload middleware: processes uploads
server/src/routes/imageRoutes.js - Image routes → Image operations: dispatches
server/src/routes/imageRoutes.js - Image operations → Upload utility: uses upload helpers
server/src/controllers/imageController.js - User routes → User operations: dispatches
server/src/routes/userRoutes.js - User routes → JWT authorization: checks access
server/src/routes/userRoutes.js - Post operations → Upload utility: prepares uploads
server/src/controllers/postControllers.js - Post operations → Cloudinary: uploads media
- Post operations → PostgreSQL: reads and writes
server/src/controllers/postControllers.js - Auth operations → PostgreSQL: reads and writes
server/src/controllers/authController.js - Auth operations → Auth state: returns credentials
- User operations → PostgreSQL: reads and writes
server/src/controllers/userControllers.js - Express server → Cloudinary: configures service
server/src/server.js