🎓 Lpu Now

A real-time university chat platform with voice calling

---

✨ What is Lpu Now?

Lpu Now is an open-source, real-time chat platform built for university students. Think WhatsApp — but designed specifically for campus life, with registration-number-based login, group chats, voice calls, and announcements.

Demo video : https://tinyurl.com/5776tzrv

REAL WEBSITE : https://lpunow.seelam.app

Key Features

Feature	Description
💬 Real-time Chat	Instant messaging with read receipts (✓✓ blue ticks)
📞 Voice Calling	Peer-to-peer WebRTC calls — zero server bandwidth
🔐 Reg Number Auth	Login with your university registration number
📎 File Sharing	Share images, PDFs, and documents
👥 Group Chats	Create and manage group conversations
📢 Announcements	University-wide broadcast messages
🌙 Dark Mode	Toggle between light and dark themes
📱 Responsive	Works on desktop and mobile

---

🚀 Quick Start

1. Clone & Install

git clone https://github.com/Svamsi2006/lpulive.git
cd lpulive
npm install

2. Configure Environment

cp .env.example .env
# Edit .env and set JWT_SECRET

3. Run

npm start

This starts both servers:

• Frontend → http://localhost:3000
• Backend API → http://localhost:5000

4. Login with Demo Accounts

Username	Password	Name
10000001	10000001	Aarav Sharma
10000002	10000002	Priya Patel
10000003	10000003	Rohan Kumar

Tip: The login page also has clickable demo account cards — just click one and hit Sign In!

---

🏗️ Architecture

graph LR
    A[React + Vite Frontend :3000] -->|REST API| B[Express Backend :5000]
    A -->|WebSocket| B
    A -->|WebRTC Signaling| C[PeerJS Server :9000]
    B -->|Data| D[(MongoDB / In-Memory)]
    A -.->|P2P Audio| A

Loading

Layer	Technology
Frontend	React 18 + Vite
Backend	Node.js + Express
Real-time	Socket.IO
Voice Calls	PeerJS + WebRTC
Auth	JWT + Bcrypt
Database	MongoDB (optional — falls back to in-memory)

---

⚙️ Configuration

Copy .env.example to .env and configure:

Variable	Required	Default	Description
JWT_SECRET	Yes	Random (dev only)	Secret key for JWT tokens
MONGODB_URI	No	In-memory	MongoDB connection string
PORT	No	5000	Backend server port
PEER_PORT	No	9000	PeerJS signaling port

---

📂 Project Structure

lpulive/
├── api/                    # Serverless API (Vercel deployment)
├── server/                 # Local Express server + PeerJS
├── src/
│   ├── components/         # React UI components
│   ├── context/            # Socket.IO & VoiceCall contexts
│   ├── config/             # API & admin configuration
│   └── utils/              # Helper utilities
├── data/                   # Sample CSV data files
├── public/                 # Static assets & demo data
├── docs/                   # Detailed documentation
└── .env.example            # Environment variable template

---

📚 Documentation

Detailed docs are in the docs/ directory:

• Quick Start Guide — Get running in 2 minutes
• Voice Call Guide — How voice calling works
• Architecture Diagrams — Visual system design
• Admin Features — Admin panel guide
• Deployment — Deploy to production
• MongoDB Setup — Using MongoDB for persistence

---

🤝 Contributing

Contributions are welcome! Please read:

1. Contributing Guide — How to get started
2. Code of Conduct — Community standards
3. Security Policy — Reporting vulnerabilities

Main Contributors

Name	Role	Links
Vamsi Siva Ganesh	Maintainer	LinkedIn · GitHub
Sreekar M	Contributor	LinkedIn
Gunda Venkatasai	Contributor	LinkedIn

---

📄 License

This project is licensed under the MIT License.

---

Built with ❤️ using React, Node.js, Socket.IO, and WebRTC

⭐ Star this repo if you find it useful!