Skip to content

shubgoyal23/chatApp

BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

135 Commits
api_server
api_server
 
 
frontend
frontend
 
 
socket_server
socket_server
 
 
.gitignore
.gitignore
 
 
.prettierignore
.prettierignore
 
 
README.md
README.md
 
 
docker-compose.yml
docker-compose.yml
 
 

Repository files navigation

ChatApp

A production-grade, distributed real-time chat application with end-to-end encryption, group messaging, and video calling.

Live: chat.stockimagesearch.online

Features

  • Real-time messaging — WebSocket-based one-to-one and group chat
  • End-to-end encryption — RSA + AES-GCM encrypted messages
  • Video calling — WebRTC peer-to-peer video calls with call signaling
  • Group management — Create groups, manage members and admins
  • Media attachments — Image/file uploads via Cloudinary
  • Authentication — JWT (access + refresh tokens), OTP-based password reset
  • Scalable architecture — Multiple socket server instances with Redis Streams message queue

Architecture

The application is split into three services:

┌─────────────────┐     REST API      ┌──────────────────┐
│   Frontend      │ ◄───────────────► │   API Server     │
│  React + Vite   │   (auth, users,   │   Express.js     │
│  Port: 5173     │    groups, etc.)  │   Port: 8000     │
│                 │                   └───────┬──────────┘
│                 │    WebSocket              │
│                 │ ◄─────────────────────┐   │ MongoDB
│                 │  (real-time messages, │   │ Redis
│                 │   video signaling)    │   │ Cloudinary
└─────────────────┘                       │   │
                                 ┌────────▼───▼─────┐
                                 │  Socket Server   │
                                 │  Go + Gin        │
                                 │  Port: 3000/3001 │
                                 └──────────────────┘
                                          │
                           ┌──────────────┼──────────────┐
                           ▼              ▼              ▼
                        MongoDB         Redis        Cloudinary
Service Stack Role
Frontend React 19, Vite, Redux Toolkit, Ant Design, Tailwind CSS SPA — connects to API Server (REST) and Socket Server (WebSocket) directly
API Server Node.js, Express 5, MongoDB, Redis Auth, user profiles, group management, message history
Socket Server Go 1.23, Gin, gorilla/websocket WebSocket hub for real-time messaging and video call signaling

Project Structure

chatApp/
├── frontend/                   # React + Vite SPA
│   ├── src/
│   │   ├── components/
│   │   │   ├── Auth/          # Login, Register, ForgotPassword
│   │   │   ├── message/       # Sidebar, chat interface
│   │   │   ├── group/         # Group creation/management
│   │   │   └── videocall/     # WebRTC video call UI
│   │   ├── store/             # Redux slices
│   │   ├── helper/            # Utility functions
│   │   ├── constance/         # App constants
│   │   ├── socket.js          # WebSocket client
│   │   └── webrtc.js          # WebRTC implementation
│   └── package.json
│
├── api_server/                 # Express REST API
│   ├── src/
│   │   ├── controllers/       # user, message, group
│   │   ├── routes/            # /api/v1/users, /message, /group
│   │   ├── models/            # User, Message, Group, Verification (Mongoose)
│   │   ├── middleware/        # JWT auth, file upload
│   │   ├── db/                # MongoDB + Redis connections
│   │   └── utils/             # Cloudinary, email, API responses
│   ├── Dockerfile
│   └── package.json
│
├── socket_server/              # Go WebSocket + signaling server
│   ├── helpers/
│   │   ├── Socket.go          # WebSocket connection handling
│   │   ├── Mongodal.go        # MongoDB operations
│   │   ├── redis.go           # Redis operations
│   │   ├── redisStream.go     # Redis Streams message queue
│   │   ├── rsa.go             # RSA encryption
│   │   ├── Aes.go             # AES-GCM encryption
│   │   ├── scheduler.go       # Connection cleanup scheduler
│   │   ├── controller.go      # HTTP controllers
│   │   └── logger.go          # Uber Zap logging
│   ├── models/                # Go data models
│   ├── router/                # Gin router setup
│   ├── main.go
│   ├── Dockerfile
│   └── go.mod
│
└── docker-compose.yml          # Multi-service production setup

Tech Stack

Frontend

Package Version Purpose
React 19.1.0 UI framework
Vite 6.3.5 Build tool
Redux Toolkit 2.8.1 State management
Ant Design 5.25.1 UI component library
Tailwind CSS 4.1.6 Utility-first styling
React Hook Form 7.56.3 Form handling
crypto-js / node-forge 4.2.0 / 1.3.1 Client-side encryption

API Server

Package Version Purpose
Express 5.1.0 HTTP framework
Mongoose 8.1.3 MongoDB ODM
Redis 5.0.1 Caching
jsonwebtoken 9.0.2 JWT auth
bcryptjs 3.0.2 Password hashing
Cloudinary 2.6.1 Media uploads
nodemailer 7.0.3 Email (OTP, notifications)
multer 1.4.5-lts.2 File upload handling

Socket Server

Package Version Purpose
Gin 1.10.0 HTTP/WebSocket framework
gorilla/websocket 1.5.3 WebSocket connections
mongo-driver 1.17.1 MongoDB driver
redigo 1.9.2 Redis client
golang-jwt 3.2.2 JWT validation
uber-go/zap 1.27.0 Structured logging

API Reference

Users — /api/v1/users

Method Endpoint Auth Description
POST /register — Register new user
POST /login — Login
POST /forgot-password — Initiate password reset
POST /check-otp — Verify OTP
POST /reset-password — Reset password with OTP
GET /logout ✓ Logout
GET /info ✓ Get user info
GET /user ✓ Get current user profile
POST /user-edit ✓ Update profile
POST /user-edit-otp ✓ Send OTP for profile change
POST /list ✓ Search users
POST /avatar ✓ Set avatar URL
POST /avatar-upload ✓ Upload avatar to Cloudinary

Messages — /api/v1/message

Method Endpoint Auth Description
POST /all ✓ Get message history (paginated)
POST /contacts ✓ Get contact list

Groups — /api/v1/group

Method Endpoint Auth Description
POST /new ✓ Create group
POST /delete ✓ Delete group
POST /add/member ✓ Add member
POST /add/admin ✓ Add admin
POST /remove/member ✓ Remove member
POST /remove/admin ✓ Remove admin
POST /description ✓ Update description
POST /name ✓ Update name
POST /check-group-name ✓ Check name availability

Socket Server — Gin

Method Endpoint Auth Description
GET /ping — Health check
GET /publickey — Get RSA public key
GET /user/key RSA+Cookie Get AES session key
GET /ws Token WebSocket connection

Environment Variables

API Server

PORT=8000
MONGODB_URI=mongodb+srv://...
MONGO_DB=chatzz
REDIS_HOST=redis://...
REDIS_PWD=your_redis_password
ACCESS_TOKEN_SECRET=your_jwt_secret
ACCESS_TOKEN_EXPIRY=1d
REFRESH_TOKEN_SECRET=your_refresh_secret
REFRESH_TOKEN_EXPIRY=10d
CORS_ORIGIN=http://localhost:5173
CLOUDINARY_CLOUD_NAME=your_cloud_name
CLOUDINARY_API_KEY=your_api_key
CLOUDINARY_API_SECRET=your_api_secret
NODE_ENV=development

Socket Server

PORT=8000
PORT_GIN=3000
GIN_MODE=debug
MONGODB_URI=mongodb+srv://...
MONGO_DB=chatzz
REDIS_HOST=redis://...
REDIS_PWD=your_redis_password
ACCESS_TOKEN_SECRET=your_jwt_secret
ACCESS_TOKEN_EXPIRY=1d
REFRESH_TOKEN_SECRET=your_refresh_secret
REFRESH_TOKEN_EXPIRY=10d
CORS_ORIGIN=http://localhost:5173
VM_ID=vm1

Frontend

VITE_API_URL=http://localhost:8000
VITE_WS_URL=http://localhost:3000
VITE_GIN_URL=http://localhost:3000

Getting Started

Prerequisites

  • Node.js 22+
  • Go 1.23+
  • MongoDB instance (local or Atlas)
  • Redis instance (local or Redis Cloud)
  • Cloudinary account (for media uploads)

1. Clone the repository

git clone <repo-url>
cd chatApp

2. Start the API Server

cd api_server
cp .env.example .env   # fill in your values
npm install
npm run dev

3. Start the Socket Server

cd socket_server
cp .env.example .env   # fill in your values
go mod download
go run main.go

4. Start the Frontend

cd frontend
cp .env.example .env.local   # fill in your values
npm install
npm run dev

Frontend will be available at http://localhost:5173.

Docker Deployment

Full stack (production)

# From project root — starts 2× socket server + 1× API server
docker compose up -d

Socket server only (local dev)

cd socket_server
docker compose up -d

Build images manually

docker build -t chatapp-api ./api_server
docker build -t chatapp-socket ./socket_server

The socket server Docker image uses a multi-stage build (Go binary compiled in golang:alpine, run in alpine:3.21) with a non-root user for security.

Security

  • JWT auth — Access tokens (short-lived) + refresh tokens (long-lived), stored in HTTP-only cookies
  • RSA encryption — Used during initial handshake to transmit session keys
  • AES-GCM — All messages encrypted on the client before transmission
  • Password hashing — bcryptjs
  • OTP verification — Email-based OTP for registration and password reset
  • CORS — Strict origin allowlist

Scaling

  • Two socket server instances run in parallel behind a load balancer
  • Redis Streams used as a distributed message queue across instances
  • Each instance registers itself via a VM_ID in Redis for instance-aware routing
  • Group member sets cached in Redis for fast fan-out
  • MongoDB handles durable message and user storage

About

chatzz-frontend.vercel.app

Resources

Readme
Activity

Stars

0 stars

Watchers

1 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

 
 
 

Contributors

Languages