How rahulad12/writespace works
Writespace is a collaborative writing and discussion app: users register or log in, then access protected client pages and backend features for blogs, profiles, bookmarks, and follows. The documented posts and comments capabilities are represented, but their implementation appears incomplete or unsampled in the tree. The backend uses route/controller/service layers and PostgreSQL; the sampled authentication controller accesses the database directly. Some cross-module and post/comment relationships are documented or implied but not verified in excerpts, so those edges are dashed.
Main entry points: app.ts API app · db.ts PostgreSQL pool · user.routes.ts User routes · App.tsx Client router
Components 32
React client
- Client router
client/src/App.tsx - Auth pages
client/src/modules/auth/page.tsx - Login form
client/src/modules/auth/components/LoginForm.tsx - Register form
client/src/modules/auth/components/RegisterForm.tsx - Form state
client/src/modules/auth/hooks/useAuthForm.ts - Auth API calls
client/src/modules/auth/services/auth.service.ts - Auth state
client/src/shared/hooks/useAuth.ts - HTTP client
client/src/shared/config/apiClient.ts - Route guard
client/src/shared/components/ProtectedRoute.tsx - Home page
client/src/modules/home/page.tsx
Express API
- API app
server/src/app.ts - Auth routes
server/src/modules/auth/auth.routes.ts - Auth controller
server/src/modules/auth/auth.controller.ts - JWT middleware
server/src/shared/middleware/auth.middleware.ts - Request validator
server/src/shared/middleware/validator.ts - PostgreSQL pool
server/src/config/db.ts
Writing features
- Blog routes
server/src/modules/blog/blog.routes.ts - Blog controller
server/src/modules/blog/blog.controller.ts - Blog service
server/src/modules/blog/blog.service.ts - Bookmark routes
server/src/modules/bookmark/bookmark.routes.ts - Bookmark controller
server/src/modules/bookmark/bookmark.controller.ts - Bookmark service
server/src/modules/bookmark/bookmark.service.ts - Posts capability
server/src/modules/post - Comments capability
server/src/modules/comment
Profiles and social
- User routes
server/src/modules/user/user.routes.ts - User controller
server/src/modules/user/user.controller.ts - User service
server/src/modules/user/user.service.ts - Follow routes
server/src/modules/follow/follow.routes.ts - Follow controller
server/src/modules/follow/follow.controller.ts - Follow service
server/src/modules/follow/follow.service.ts
Other components
- User
- PostgreSQL
Connections 45
- User → Client router: uses
client/src/App.tsx - Client router → Auth pages: routes to
client/src/App.tsx - Client router → Home page: routes to
client/src/App.tsx - Client router → Route guard: guards profile
client/src/App.tsx - Auth pages → Login form: renders
client/src/modules/auth/page.tsx - Auth pages → Register form: renders
client/src/modules/auth/page.tsx - Login form → Form state: uses
client/src/modules/auth/components/LoginForm.tsx - Register form → Form state: uses
client/src/modules/auth/components/RegisterForm.tsx - Login form → Auth API calls: calls
client/src/modules/auth/components/LoginForm.tsx - Register form → Auth API calls: calls
client/src/modules/auth/components/RegisterForm.tsx - Login form → Auth state: updates
client/src/modules/auth/components/LoginForm.tsx - Register form → Auth state: updates
client/src/modules/auth/components/RegisterForm.tsx - Auth API calls → HTTP client: sends requests
client/src/modules/auth/services/auth.service.ts - Route guard → Auth state: checks
client/src/shared/components/ProtectedRoute.tsx - Home page → Auth state: reads
client/src/modules/home/page.tsx - Auth API calls → API app: calls auth and user endpoints
- API app → Auth routes: mounts
server/src/app.ts - API app → Blog routes: mounts
server/src/app.ts - API app → Bookmark routes: mounts
server/src/app.ts - API app → User routes: mounts
server/src/app.ts - Auth routes → Auth controller: dispatches
server/src/modules/auth/auth.routes.ts - Auth routes → Request validator: validates with
server/src/modules/auth/auth.routes.ts - Auth controller → PostgreSQL pool: queries
server/src/modules/auth/auth.controller.ts - PostgreSQL pool → PostgreSQL: connects
- Blog routes → Blog controller: dispatches
server/src/modules/blog/blog.routes.ts - Blog routes → JWT middleware: protects routes
server/src/modules/blog/blog.routes.ts - Blog routes → Request validator: validates with
server/src/modules/blog/blog.routes.ts - Blog controller → Blog service: calls
server/src/modules/blog/blog.controller.ts - Blog service → PostgreSQL pool: queries
server/src/modules/blog/blog.service.ts - Bookmark routes → Bookmark controller: dispatches
server/src/modules/bookmark/bookmark.routes.ts - Bookmark routes → JWT middleware: protects routes
server/src/modules/bookmark/bookmark.routes.ts - Bookmark controller → Bookmark service: calls
server/src/modules/bookmark/bookmark.controller.ts - Bookmark service → PostgreSQL pool: queries
server/src/modules/bookmark/bookmark.service.ts - API app → Posts capability: may expose
- API app → Comments capability: may expose
- User routes → User controller: dispatches
server/src/modules/user/user.routes.ts - User routes → Follow controller: dispatches profile follow queries
server/src/modules/user/user.routes.ts - User routes → JWT middleware: protects routes
server/src/modules/user/user.routes.ts - User routes → Request validator: validates with
server/src/modules/user/user.routes.ts - User controller → User service: calls
server/src/modules/user/user.controller.ts - User service → PostgreSQL pool: queries
server/src/modules/user/user.service.ts - Follow routes → Follow controller: dispatches
server/src/modules/follow/follow.routes.ts - Follow routes → JWT middleware: protects routes
server/src/modules/follow/follow.routes.ts - Follow controller → Follow service: calls
server/src/modules/follow/follow.controller.ts - Follow service → PostgreSQL pool: queries
server/src/modules/follow/follow.service.ts