RoomMate is a modern full-stack web application designed to help students, working professionals, and travelers find suitable rooms and compatible roommates. The platform simplifies the accommodation search process through smart filtering, detailed listings, secure communication, and an intuitive user experience.
Finding a room or a compatible roommate can be challenging, especially when moving to a new city. RoomMate provides a centralized platform where users can:
- Search available rooms
- Find roommates with similar preferences
- Post room listings
- Manage accommodation details
- Connect with potential roommates
The platform aims to make housing discovery faster, safer, and more convenient.
- Post room availability
- Upload room images
- Add rent details
- Mention amenities and facilities
- Location-based listings
- Create roommate profiles
- Match based on preferences
- View roommate requirements
- Connect with potential roommates
- Search by city
- Filter by rent range
- Filter by room type
- Gender preferences
- Amenities-based filtering
- Save favorite rooms
- Bookmark roommate profiles
- Quick access to saved searches
- Direct messaging
- Contact listing owners
- Inquiry management
- Mobile Friendly
- Tablet Compatible
- Desktop Optimized
- Secure Registration
- Login & Logout
- JWT Authentication
- Protected Routes
- User Profile Management
- React.js
- TypeScript
- Tailwind CSS
- Vite
- Axios
- Node.js
- Express.js
- TypeScript
- MongoDB
- Prisma ORM
- JWT
- bcrypt
- Cloudinary
- Git
- GitHub
- Postman
- VS Code
roommate/
│
├── frontend/
│ ├── src/
│ │ ├── components/
│ │ ├── pages/
│ │ ├── hooks/
│ │ ├── services/
│ │ ├── layouts/
│ │ └── assets/
│ │
│ └── package.json
│
├── backend/
│ ├── src/
│ │ ├── controllers/
│ │ ├── routes/
│ │ ├── middleware/
│ │ ├── models/
│ │ └── config/
│ │
│ └── package.json
│
├── screenshots/
├── README.md
└── .gitignore🔗 Live Website:
https://your-live-demo-link.com
https://your-demo-video-link.com
git clone https://github.com/your-username/roommate.gitcd roommatecd frontend
npm installcd ../backend
npm installCreate a .env file inside the backend folder:
PORT=5000
DATABASE_URL=your_database_url
JWT_SECRET=your_jwt_secret
CLOUDINARY_CLOUD_NAME=your_cloud_name
CLOUDINARY_API_KEY=your_api_key
CLOUDINARY_API_SECRET=your_api_secretnpm run devcd ../frontend
npm run dev- User Registration
- User Login
- Password Encryption
- Session Management
- Add Listings
- Edit Listings
- Delete Listings
- Upload Images
- Profile Creation
- Preference Matching
- Recommendations
- Smart Filtering
- Sorting Options
- Location Search
- 🤖 AI-Based Roommate Matching
- 📍 Google Maps Integration
- 💬 Real-Time Chat
- 🔔 Push Notifications
- 📅 Room Booking System
- ⭐ Reviews & Ratings
- 📊 User Analytics Dashboard
- 🌙 Dark Mode
- 📱 Mobile Application
Run tests:
npm testThis project demonstrates:
- Full-Stack Web Development
- REST API Development
- Authentication & Authorization
- Database Design
- File Upload Management
- Responsive UI Development
- State Management
- Secure Application Architecture
Contributions are welcome!
- Fork the repository
- Create a feature branch
git checkout -b feature/new-feature- Commit changes
git commit -m "Added new feature"- Push changes
git push origin feature/new-feature- Open a Pull Request
Rohan Vyavahare
GitHub: https://github.com/Rohan-og4788
This project is licensed under the MIT License.
If you found this project useful, please consider giving it a ⭐ on GitHub.
Your support helps improve the project and encourages future development.