A real-time video chat application built with React, Go, and WebRTC technology. PolyChat enables users to create and join video meetings with multiple participants, featuring peer-to-peer video/audio streaming, real-time chat, and seamless WebSocket signaling.
- 🎥 Real-time Video & Audio - WebRTC-based peer-to-peer communication
- 👥 Multi-user Meetings - Support for multiple participants in a single room
- 💬 Live Chat - Text messaging during video calls
- 🔗 Shareable Meeting Links - UUID-based meeting rooms
- 🔐 Secure Authentication - JWT-based user authentication with bcrypt password hashing
- 🌐 WebSocket Signaling - Real-time signaling for WebRTC connections
- 📱 Responsive Design - Built with Tailwind CSS and Radix UI components
- 🎬 Graceful Fallbacks - Automatic fallback when camera/microphone unavailable
- 🔄 Auto-reconnection - WebSocket reconnection on connection loss
Frontend:
- ⚛️ React 19 with Vite
- 🎨 Tailwind CSS 4 for styling
- 🧩 Radix UI components
- 🔄 Zustand for state management
- 🌐 WebRTC for video/audio streaming
- 🔌 WebSocket client for signaling
Backend:
- 🐹 Go 1.25 with Chi router
- 🗄️ MongoDB Atlas for data persistence
- 🔐 JWT authentication (golang-jwt/jwt)
- 🔒 Bcrypt password hashing
- 🌐 Gorilla WebSocket for signaling server
- 🆔 UUID for unique meeting identifiers
┌─────────────────┐ ┌──────────────────┐
│ │ │ │
│ React Client │◄───────►│ Go Server │
│ (Frontend) │ HTTP │ (Backend) │
│ │ REST │ │
└────────┬────────┘ └────────┬─────────┘
│ │
│ WebSocket │
│ Signaling │ MongoDB
│ │ Atlas
└───────────┬───────────────┘
│
┌──────▼──────┐
│ WebRTC │
│ P2P Streams │
└─────────────┘
- Node.js 18+ and npm
- Go 1.21+
- MongoDB Atlas account (or local MongoDB)
- OpenSSL (for generating secrets)
git clone https://github.com/rishishanbhag/PolyChat.git
cd PolyChatcd server
# Copy environment template
cp .env.example .env
# Edit .env and add your credentials:
# - MONGODB_URI: Your MongoDB connection string
# - JWT_SECRET: Generate with: openssl rand -base64 48
# - ALLOWED_ORIGINS: Frontend URLs (e.g., http://localhost:5173)
# Install dependencies
go mod download
# Run the server
go run cmd/api/main.go
# Or using Make
make runServer will start on http://localhost:8080
cd client
# Copy environment template
cp .env.example .env
# Edit .env if needed (defaults work for local development):
# - VITE_API_URL=http://localhost:8080/api
# - VITE_WS_URL=ws://localhost:8080/api/ws
# Install dependencies
npm install
# Run development server
npm run devClient will start on http://localhost:5173
Server (.env):
PORT=8080
MONGODB_URI=mongodb+srv://username:password@cluster.mongodb.net/
DATABASE_NAME=polychat
JWT_SECRET=<generate-with-openssl-rand-base64-48>
ALLOWED_ORIGINS=http://localhost:5173,http://localhost:3000Client (.env):
VITE_API_URL=http://localhost:8080/api
VITE_WS_URL=ws://localhost:8080/api/wsSee SECURITY.md for detailed security guidelines.
-
Sign Up / Login
- Create an account or login with existing credentials
- JWT token stored securely in localStorage
-
Create a Meeting
- Click "Create Meeting" from the dashboard
- Share the generated meeting link with participants
-
Join a Meeting
- Click on a meeting from your list
- Or use a shared meeting link
- Grant camera/microphone permissions when prompted
-
During the Meeting
- See all participants' video streams
- Use chat for text communication
- Video/audio will automatically fall back if devices unavailable
POST /api/auth/signup- Register new userPOST /api/auth/login- Login userPOST /api/auth/logout- Logout user
GET /api/meetings- List user's meetingsPOST /api/meetings- Create new meetingGET /api/meetings/:id- Get meeting detailsGET /api/meetings/link/:linkId- Get meeting by shareable linkPOST /api/meetings/:id/join- Join a meeting
WS /api/ws?userId=<id>&username=<name>&roomId=<room>- WebSocket signaling connection
server/
├── cmd/api/main.go # Application entry point
├── internal/
│ ├── auth/ # JWT utilities
│ ├── database/ # MongoDB connection
│ ├── handlers/ # HTTP request handlers
│ ├── middleware/ # Auth middleware
│ ├── models/ # Data models
│ ├── repository/ # Database operations
│ ├── server/ # Server setup & routes
│ └── websocket/ # WebSocket hub & clients
├── .env.example # Environment template
└── go.mod # Go dependencies
client/
├── src/
│ ├── components/ # React components
│ │ ├── ChatBox.jsx # Chat component
│ │ └── ui/ # Reusable UI components
│ ├── lib/
│ │ ├── api.js # HTTP API client
│ │ ├── websocket.js # WebSocket client
│ │ └── webrtc.js # WebRTC manager
│ ├── pages/ # Page components
│ │ ├── DashboardPage.jsx
│ │ ├── LoginPage.jsx
│ │ ├── SignupPage.jsx
│ │ └── MeetingRoomPage.jsx
│ ├── store/
│ │ └── useStore.js # Zustand state management
│ ├── App.jsx # Root component
│ └── main.jsx # Application entry
├── .env.example # Environment template
└── package.json # Dependencies
make build # Build the application
make run # Run the application
make test # Run tests- ✅ JWT-based authentication with 24-hour token expiration
- ✅ Bcrypt password hashing (no plaintext storage)
- ✅ Environment-based configuration (no hardcoded secrets)
- ✅ CORS protection with configurable origins
- ✅ Password fields excluded from JSON responses
- ✅
.envfiles properly gitignored
Important: Read SECURITY.md before deploying to production.
Contributions are welcome! Please follow these steps:
- Fork the repository
- Create a feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
This project is licensed under the MIT License.
Rishi Shanbhag
- GitHub: @rishishanbhag
Built with ❤️ by Rishi