Chronex 🕒

A production-grade, high-performance web application designed for global teams to navigate time zones, plan synchronized meetings, execute deep work sessions, and manage distributed operations with ease.

✨ Key Features

• Smart Meeting Planner: Automated overlap detection using heatmaps and AI-driven optimal time suggestions that dynamically adapt to your local timezone.
• Focus Engine & Pomodoro: Built-in deep work management featuring customizable Pomodoro timers, task tracking, and ambient global awareness.
• Live World Clocks: Real-time synchronized digital clocks with intelligent DST (Daylight Saving Time) handling.
• Real-Time Collaboration: Socket.io integration ensures seamless, instantaneous state synchronization across all active clients for meetings and presence.
• Interactive Time Scrubber: A fluid, drag-and-drop timeline allowing teams to cross-reference past and future times effortlessly.
• Team Intelligence: Organization-wide availability dashboards and API usage analytics.
• Enterprise-Grade Security: JWT authentication with refresh rotation, granular rate limiting, and encrypted data storage.

🚀 Technical Stack

Frontend

• Framework: React 18 (Vite-powered)
• State Management: Zustand & TanStack Query
• Real-Time: Socket.io Client
• Animation: Framer Motion
• Data Visualization: Recharts
• Time Management: Luxon

Backend

• Runtime: Node.js v18+
• Framework: Express.js
• Database: MongoDB (Mongoose ODM)
• Caching: Redis
• Real-Time: Socket.io
• Security: Helmet.js, JWT, Express Rate Limit
• Testing: Vitest, Supertest

🛠️ Setup & Installation

Prerequisites

• Node.js v18+
• MongoDB & Redis (local or managed)
• Docker & Docker Compose (optional)

Local Development

1. Clone & Install

   # Backend dependencies
   cd server && npm install
   
   # Frontend dependencies
   cd client && npm install

2. Environment Configuration Create a .env file in the server directory based on .env.example.

3. Start Development Servers

   # In /server
   npm run dev
   
   # In /client
   npm run dev

Running Tests

# In /server
npm test

Dockerized Deployment

# Root directory
docker-compose up --build

📐 Architecture

Chronex leverages a Clean Architecture pattern to ensure scalability and maintainability:

• Presentation Layer: React components and hooks for UI logic.
• API Layer: Express controllers handling I/O.
• Business & Event Layer: Services for complex logic (time calculations, analytics) and Socket implementations for real-time events.
• Data Layer: Repositories for database and cache abstraction.

🔒 Security & Compliance

• OWASP Best Practices: Configured with Helmet.js for secure HTTP headers.
• Rate Limiting: Integrated protection against DDoS and automated brute-force attempts.
• Stateful Auth: Secure JWT implementation with industry-standard signing.