A modern, high-performance team collaboration platform engineered with React 19, Tailwind CSS, Node.js / Express, and MongoDB Atlas.
The codebase is organized following Clean Layered Architecture on the backend and Feature/Modular Architecture on the frontend, ensuring high maintainability, testability, and separation of concerns.
teamsync-collab-platform/
├── backend/ # Node.js & Express REST API
│ ├── config/ # Environment & Database configurations
│ │ └── db.js # Resilient Mongoose connection lifecycle
│ ├── controllers/ # HTTP Request & Response handlers
│ │ ├── authController.js # Authentication & Google OAuth
│ │ ├── notificationController.js# Notifications & alerts
│ │ ├── taskController.js # Task endpoints logic
│ │ └── teamMemberController.js # Team member endpoints logic
│ ├── middlewares/ # Express middleware pipeline
│ │ ├── authMiddleware.js # JWT verification (protect)
│ │ ├── errorHandler.js # Centralized global error handling
│ │ └── notFound.js # 404 Route Not Found handler
│ ├── models/ # Mongoose Domain Schemas
│ │ ├── Notification.js # Notifications schema & indices
│ │ ├── Task.js # Deliverables & milestone schema
│ │ ├── TeamMember.js # Collaborators schema
│ │ └── User.js # User accounts & auth credentials
│ ├── routes/ # API Route Definitions
│ │ ├── index.js # Central router aggregation (/api)
│ │ ├── authRoutes.js # /api/auth routes
│ │ ├── notificationRoutes.js # /api/notifications routes
│ │ ├── taskRoutes.js # /api/tasks routes
│ │ └── teamRoutes.js # /api/team routes
│ ├── services/ # Domain Business Logic & DB queries
│ │ ├── authService.js # Google verification & JWT sessions
│ │ ├── notificationService.js # Notification queries & auto-triggers
│ │ ├── taskService.js # Task CRUD & query operations
│ │ └── teamService.js # Member CRUD & query operations
│ ├── utils/ # Shared server utilities
│ │ ├── ApiError.js # Operational error subclass
│ │ ├── asyncHandler.js # Promise error wrapper
│ │ └── generateToken.js # JWT signing helper
│ ├── app.js # Express app configuration & middleware
│ ├── server.js # Bootstrapper, DB connect & graceful shutdown
│ ├── .env.example # Backend environment template
│ └── package.json
│
├── frontend/ # React 19 + Vite Single Page Application
│ ├── src/
│ │ ├── api/ # Centralized API layer
│ │ │ └── client.js # Axios client with auth interceptor
│ │ ├── components/ # Modular UI Component Library
│ │ │ ├── common/ # Reusable design primitives
│ │ │ │ ├── Icons.jsx # Zero-dependency SVG vector icon system
│ │ │ │ ├── Modal.jsx # Accessible, responsive scrollable modal
│ │ │ │ └── ProtectedRoute.jsx# Auth routing guard
│ │ │ ├── layout/ # Application shell & navigation
│ │ │ │ ├── Header.jsx # Sticky top navigation bar with notification bell
│ │ │ │ ├── Layout.jsx # Viewport-locked master shell
│ │ │ │ └── Sidebar.jsx # Pinned SaaS navigation sidebar with user profile
│ │ │ ├── notifications/ # Notification center components
│ │ │ │ └── NotificationMenu.jsx # Real-time notification flyout popover
│ │ │ └── index.js # Barrel exports
│ │ ├── context/ # Global Application State
│ │ │ ├── AuthContext.jsx # User authentication & session state
│ │ │ └── NotificationContext.jsx # Live notifications state & polling
│ │ ├── pages/ # Application Views
│ │ │ ├── Calendar.jsx # Interactive monthly grid with task pills
│ │ │ ├── Dashboard.jsx # Real-time KPIs & upcoming deliverables
│ │ │ ├── Login.jsx # 3D flipping auth screen with Google OAuth
│ │ │ ├── Tasks.jsx # Filterable task manager with datetime picker
│ │ │ └── Team.jsx # Collaborator directory with workload metrics
│ │ ├── utils/ # Shared client utilities
│ │ │ ├── dateUtils.js # Relative countdowns & date formatting
│ │ │ └── taskHelpers.js # Priority & type badge style maps
│ │ ├── App.jsx # Route definitions wrapped in Providers
│ │ ├── main.jsx # React root entry point
│ │ └── styles.css # Tailwind CSS & 3D keyframe animations
│ ├── .env.example # Frontend environment template
│ └── vite.config.js
│
├── FEATURES.md # Feature-by-feature roadmap & system audit
└── README.md # Project documentation
- Node.js (v18.x, v20.x, or v24.x)
- MongoDB Atlas (or local MongoDB instance)
cd backend
cp .env.example .env
# Configure your MONGO_URI, JWT_SECRET, and GOOGLE_CLIENT_ID in .env
npm install
npm run devThe API server starts at http://localhost:5000 with health check at http://localhost:5000/health.
cd frontend
cp .env.example .env
# Configure VITE_API_URL and VITE_GOOGLE_CLIENT_ID in .env
npm install
npm run devThe React SPA will launch at http://localhost:5173.
| Method | Endpoint | Description |
|---|---|---|
GET |
/health |
Server health check |
| Method | Endpoint | Description |
|---|---|---|
POST |
/api/auth/google |
Authenticate or register with Google OAuth ID token (auto-links matching Gmail) |
POST |
/api/auth/register |
Register a new local user with email & password |
POST |
/api/auth/login |
Login with existing email & password |
GET |
/api/auth/me |
Fetch currently authenticated user profile |
| Method | Endpoint | Description |
|---|---|---|
GET |
/api/tasks |
Get all tasks (chronologically sorted) |
GET |
/api/tasks/:id |
Get single task by ID |
POST |
/api/tasks |
Create a new task deliverable (triggers automated notification) |
PUT |
/api/tasks/:id |
Update an existing task (triggers automated notification) |
DELETE |
/api/tasks/:id |
Delete a task (triggers automated notification) |
| Method | Endpoint | Description |
|---|---|---|
GET |
/api/team |
Get all team members |
POST |
/api/team |
Register a new team member (triggers automated notification) |
DELETE |
/api/team/:id |
Remove a team member (triggers automated notification) |
| Method | Endpoint | Description |
|---|---|---|
GET |
/api/notifications |
Get workspace notifications & unread counts |
POST |
/api/notifications |
Create a manual notification or alert |
PATCH |
/api/notifications/read-all |
Mark all notifications as read |
PATCH |
/api/notifications/:id/read |
Mark single notification as read |
DELETE |
/api/notifications/:id |
Dismiss a single notification |
DELETE |
/api/notifications |
Clear all notifications |
| Method | Endpoint | Description |
|---|---|---|
GET |
/api/workspaces |
Get all workspaces (auto-seeds starter projects if empty) |
GET |
/api/workspaces/:id |
Get single workspace by ID |
POST |
/api/workspaces |
Create a new project workspace |
PUT |
/api/workspaces/:id |
Update workspace name or transition current sprint |
DELETE |
/api/workspaces/:id |
Remove a workspace |
Adding these engineering features transforms TeamSync into an enterprise-grade distributed system:
- Real-Time Bidirectional Sync (
Socket.io): Instant multi-client deliverable synchronization, active collaborator presence indicators, and comment feeds. - Granular RBAC Middleware & Audit Logging: Route-level permission boundaries (
Owner,Admin,Member,Guest) paired with immutable audit trails. - Idempotent Webhook Engine: Automated GitHub PR merge integration transitioning TeamSync tasks with SHA-256 signature verification.
- Redis Caching & Sliding-Window Rate Limiting: In-memory caching for dashboard aggregates and API abuse mitigation.
- Automated Deadline Engine (BullMQ + Cron): Distributed background worker queues dispatching automated reminder digests.
- AI Sprint & Task Standup Summarizer: LLM endpoint (Gemini API) generating executive sprint summaries and blocker digests.
- Production DevOps Pipeline: Multi-stage Dockerfiles, GitHub Actions CI/CD pipelines, and Swagger/OpenAPI specs.
💼 Senior Engineer CV Bullet:
Engineered a real-time team collaboration platform using React, Node.js, Express, and MongoDB, implementing WebSockets for live task synchronization, RBAC middleware for workspace security, and Redis caching to cut dashboard query latency.
See FEATURES.md for full architectural specifications, live vs. hardcoded system audit, and detailed implementation checklists.