Skip to content

Repository files navigation

📱 WhatsApp Clone – Full Stack Real-Time Chat App

License Stars Issues Last Commit

A modern WhatsApp Clone built using Next.js, Clerk, Convex, and ZEGOCLOUD. Includes features such as secure authentication, real-time messaging, video/group calls, dark/light themes, and responsive UI.

⚡ This project showcases an advanced real-time chat system with cloud-native backend and UI integrations.


📚 Table of Contents


✨ Features

  • 🔐 Authentication via Clerk.dev
  • 💬 Real-time messaging powered by Convex
  • 📞 1:1 and group video calls with ZEGOCLOUD
  • 🎨 Light/Dark theme toggle
  • 👥 Group management (kick/ban users)
  • 🧑‍💼 User profile updates (avatar, bio, etc.)
  • 📩 Webhooks for real-time presence and notifications
  • 📱 Mobile-first responsive UI

🛠️ Technologies Used

Tech Role
Next.js Frontend / SSR
React.js UI layer
Clerk Authentication & sessions
Convex Serverless backend logic
ZEGOCLOUD Video call SDK
Tailwind CSS Styling
DaisyUI UI components
Radix UI Accessibility-first UI
Webhooks Real-time syncing

📦 Installation

Prerequisites

  • Node.js (v18+)
  • Convex CLI

1. Convex Setup

npx convex dev

2. Install Dependencies

npm install

3. Environment Variables

Create a .env.local file in the root directory:

CONVEX_DEPLOYMENT=dev:friendly-lion-123
NEXT_PUBLIC_CONVEX_URL=https://friendly-lion-123.convex.cloud

NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_test_your_publishable_key
CLERK_SECRET_KEY=sk_test_your_secret_key

ZEGO_APP_ID=123456789
ZEGO_SERVER_SECRET=your_zego_server_secret

🚀 Running the App

npm run dev

Then open http://localhost:3000 to view it in your browser.


🖼️ Screenshots

🖼️ Feature Image
Main Page (Light) light
Main Page (Dark) dark
Group Video Call videocall
Profile Page profile
Group Members members
Emoji Bar emoji

🤝 Contributing

  1. 🍴 Fork this repo
  2. 🌿 Create your feature branch: git checkout -b feature/feature-name
  3. 💾 Commit your changes: git commit -m 'Add feature'
  4. 📤 Push to the branch: git push origin feature/feature-name
  5. 🔁 Open a pull request

We welcome contributions of all kinds!


📄 License

Licensed under the MIT License.
See LICENSE for more information.


📬 Contact

Project Maintainer: @kgnio

About

A full-stack real-time chat application inspired by WhatsApp. Built with modern web technologies, featuring user authentication, one-to-one and group messaging, online status indicators, and a responsive UI.

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages