🏠 StayMates - Where Every Stay Feels Like Home

(https://img.shields.io/badge/Made%20with%20❤️%20by-Parth%20Rai-red.svg)](https://github.com/IMFParth)

🚀 The Ultimate Roommate & Accommodation Platform That's Changing How People Find Their Perfect Stay! 🚀

🌟 LIVE DEMO | 📖 Documentation | 🤝 Contribute | 💬 Discord

---

🎯 Why StayMates is Going Viral

"This isn't just another housing app - it's a complete ecosystem that solves the #1 problem every student and young professional faces!" - Early User Review

🔥 What Makes StayMates Special?

• 🧠 Smart AI Matching: Our algorithm doesn't just match locations - it matches lifestyles, habits, and personalities
• 💬 Real-time Chat: Instant communication with potential roommates and property owners
• 🔒 Verified Profiles: Every user is verified with Aadhaar integration for maximum safety
• 📱 Mobile-First Design: Stunning UI that works flawlessly on every device
• 🌍 Location Intelligence: Advanced mapping with neighborhood insights
• ⚡ Lightning Fast: Built with modern tech stack for blazing performance

---

🎬 See It In Action

🏡 Find Your Perfect Match

Smart roommate matching based on lifestyle preferences

💼 Host Like a Pro

Professional property management tools

🤝 Connect Instantly

Real-time messaging and friend requests

🎥 Watch Demo Video | 📱 Try Live App

---

✨ Features That Users Love

🔐 Authentication & Security ✅ Email verification with OTP ✅ JWT-based secure sessions ✅ Aadhaar number verification ✅ Password encryption with bcrypt ✅ Rate limiting & CORS protection 👤 Smart Profile System ✅ Comprehensive user profiles ✅ Lifestyle preference matching ✅ Social media integration ✅ Profile picture management ✅ University & location details

🏠 Property Management ✅ Multi-image property listings ✅ Flexible rent options (daily/weekly/monthly) ✅ Advanced search & filters ✅ Interactive maps integration ✅ Availability calendar 💬 Communication Hub ✅ Real-time messaging system ✅ Friend request management ✅ Interest notifications ✅ Email alerts ✅ Chat room creation

---

🛠️ Built With Cutting-Edge Tech

Backend Powerhouse

Frontend Excellence

DevOps & Monitoring

---

🚀 Quick Start Guide

Prerequisites

Node.js >= 18.0.0
PostgreSQL >= 13
Git

1️⃣ Clone & Install

git clone https://github.com/IMFParth/StayMates.git
cd StayMates
npm install

2️⃣ Environment Setup

cp .env.example .env

Edit .env with your configuration:

DB_HOST=localhost
DB_PORT=5432
DB_NAME=staymates
DB_USER=your_db_user
DB_PASSWORD=your_db_password
SESSION_SECRET=your_super_secret_key
JWT_SECRET=your_jwt_secret
EMAIL_USER=your_email@gmail.com
EMAIL_PASS=your_app_password

3️⃣ Database Setup

createdb staymates
npm run db:init

4️⃣ Launch 🚀

npm run dev

🎉 Open http://localhost:3000 and experience the magic!

---

🐳 Docker Deployment

Development

docker-compose up -d

Production

docker build -t staymates:latest .
docker run -d --name staymates-prod -p 3000:3000 --env-file .env.production staymates:latest

---

📊 Monitoring & Analytics

StayMates comes with built-in monitoring using Prometheus & Grafana:

npm run monitoring:up

Access Grafana at http://localhost:3001 (admin/admin)

---

🏗️ Project Architecture

StayMates/
├── 🗄️  database/           # Database schemas & migrations
├── 📊  monitoring/         # Prometheus & Grafana configs  
├── 🎨  src/
│   ├── 📁  public/         # Static assets (CSS, JS, Images)
│   ├── 🖼️  views/          # EJS templates
│   ├── ⚙️  config/         # Configuration files
│   ├── 📋  models/         # Data models
│   └── 🚀  server.js       # Main application
├── 🐳  docker-compose.yml  # Container orchestration
├── 📦  package.json        # Dependencies & scripts
└── 📖  README.md          # You are here!

---

🎯 Available Scripts

Command	Description
npm start	🚀 Start production server
npm run dev	🔧 Development with hot reload
npm run build	🏗️ Build CSS and assets
npm test	🧪 Run test suite
npm run lint	🔍 Code quality check
npm run docker:dev	🐳 Docker development
npm run monitoring:up	📊 Start monitoring stack

---

🌟 Why Developers Love StayMates

"Clean code, modern architecture, and actually solves a real problem. This is how you build software!"
- Senior Developer Review

"The monitoring setup is chef's kiss 👌. Production-ready from day one."
- DevOps Engineer

"Finally, a housing platform that doesn't suck. The UX is incredible!"
- Product Manager

---

---

📈 Roadmap

• 📱 Mobile App (React Native)
• 🤖 AI Chatbot for instant support
• 💳 Payment Integration (Stripe/Razorpay)
• 🌍 Multi-language Support
• 📊 Advanced Analytics Dashboard
• 🔔 Push Notifications
• 🎥 Video Chat Integration
• ⭐ Review & Rating System

---

---

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

🙏 Acknowledgments

• 💡 Inspiration: The struggle of finding good roommates in college
• 🎨 Design: Modern web design principles and user feedback
• 🛠️ Tech Stack: Amazing open-source community
• 🚀 Deployment: Render.com for reliable hosting

---

🌟 If StayMates helped you find your perfect stay, give it a star!

Made with ❤️ by Parth Rai

Changing how people find their perfect stay, one match at a time.

# Stay-Mates # Stay-Mates # Stay-Mates # Stay-Mates