Skip to main content

Connect with Your Campus Community

MeetMates is a college-exclusive platform that brings students together through random video calls. Verified, secure, and designed for meaningful connections.

Get StartedLearn More

Quick Start

Get MeetMates up and running in minutes

1

Clone the Repository

First, clone the MeetMates repository to your local machine:
Terminal
git clone https://github.com/divyanshraj0408/meetmates.git
cd meetmates
2

Install Dependencies

Install dependencies for both frontend and backend:
Terminal
cd frontend && npm install
cd ../backend && npm install
3

Configure Environment

Set up your environment variables for both the frontend and backend:
frontend/.env
VITE_BACKEND_URL=http://localhost:3001
VITE_GOOGLE_CLIENT_ID=your_google_client_id
backend/.env
MONGODB_URI=your_mongodb_uri
JWT_SECRET=your_jwt_secret
CORS_ORIGIN=http://localhost:5173
PORT=3001
You’ll need to obtain a Google OAuth Client ID from the Google Cloud Console.
4

Start the Application

Launch both the frontend and backend servers:
Terminal
# In the backend directory
npm start

# In a new terminal, in the frontend directory
npm run dev
Your application will be running at http://localhost:5173!

Explore by Topic

Dive into specific features and capabilities

Video Chat

Learn about WebRTC-powered peer-to-peer video connections

Random Matching

Discover how users are paired for conversations

Authentication

Explore Google OAuth and email-based authentication

Safety Features

Understand reporting, blocking, and moderation tools

Development Setup

Set up your local development environment

Architecture

Understand the system design and technology stack

Key Features

What makes MeetMates special

🎓

College Email Verification

Ensures only verified college students can join, creating a safe and authentic community environment.

🎥

Real-Time Video Streaming

Powered by WebRTC for smooth, low-latency peer-to-peer video communication without intermediary servers.

💬

Text Chat Support

Real-time text messaging during video calls for a richer communication experience.

🔒

Privacy & Security

JWT-based authentication, secure socket connections, and user reporting features ensure a safe platform.

API Reference

Explore the REST API and Socket.io events

Authentication API

Google OAuth, signup, login, and token verification endpoints

Socket Events

Real-time events for matching, WebRTC signaling, and messaging

Ready to Get Started?

Set up MeetMates locally and start building connections in your campus community.

Get Started Now