MessFinder is a final-year graduation project designed to bridge the gap between students or working professionals seeking accommodation and property owners offering rooms or mess facilities. The platform serves as an intermediary, facilitating easy connections and ensuring a seamless experience for both parties.
🔗 Live Demo: mess-finder.vercel.app
- User Registration & Login: Secure authentication for both students/professionals and room owners.
- Profile Management: Users can update personal details, preferences, and accommodation requirements.
- Search & Filter: Advanced search options to find available rooms or mess facilities based on location, price, and amenities.
- Booking System: Direct communication between users and owners to discuss terms and finalize bookings.
- Admin Dashboard: Admin panel to manage users, listings, and oversee platform activities.
MessFinder/
├── src/
│ ├──components/
│ │ ├── error/
│ │ │ ├── error.jsx
│ │ │ └── index.jsx
│ │ ├── layout/
│ │ │ ├── footer.jsx
│ │ │ ├── header.jsx
│ │ │ └── index.jsx
│ │ ├── owner-form/
│ │ │ ├── AccommodationDetails.jsx
│ │ │ ├── FormButtons.jsx
│ │ │ ├── ImageUpload.jsx
│ │ │ ├── index.jsx
│ │ │ └── MessDetails.jsx
│ │ └── ui/
│ │ ├── alert.jsx
│ │ ├── button.jsx
│ │ ├── index.jsx
│ │ ├── input.jsx
│ │ ├── loader.jsx
│ │ ├── logo.jsx
│ │ ├── option.jsx
│ │ └── set-role.jsx
│ ├── context/
│ │ ├── firebase.jsx
│ │ ├── firebase-config.js
│ │ ├── firebase-rtb.jsx
│ │ ├── firebase-storage.jsx
│ │ └── useGoogleAuth.jsx
│ ├── module/
│ │ ├── css/
│ │ └── js/
│ │ ├── district-pin.js
│ │ ├── navItems.js
│ │ ├── relative-time.js
│ │ └── string.js
│ └── pages/
│ ├── auth/
│ │ ├── index.jsx
│ │ ├── login.jsx
│ │ ├── logout.jsx
│ │ ├── register.jsx
│ │ └── reset.jsx
│ ├── dashboard/
│ │ ├── bookmarks.jsx
│ │ ├── dashboard.jsx
│ │ ├── index.jsx
│ │ ├── messages.jsx
│ │ ├── owner/
│ │ │ ├── mypgs.jsx
│ │ │ └── submit-pg.jsx
│ │ ├── profile.jsx
│ │ └── settings.jsx
│ ├── home/
│ │ ├── homeSearch.jsx
│ │ └── index.jsx
│ ├── info/
│ │ ├── about.jsx
│ │ ├── contact.jsx
│ │ ├── faqs.jsx
│ │ ├── index.jsx
│ │ ├── report.jsx
│ │ └── terms.jsx
│ ├── profile/
│ │ ├── index.jsx
│ │ └── publicProfile.jsx
│ └── rooms/
│ ├── index.jsx
│ ├── room.jsx
│ └── search.jsx
├── index.css
├── Layout.jsx
├── main.jsx
├── routes.jsx
├── scroll-to-top.jsx
├── public/
│ └── ... # (images, favicon, logo, etc.)
├── index.html
├── LICENSE
├── README.md
└── ... # (all other configuration and integration files)Frontend: HTML, CSS, JavaScript, React, TailwindCSS
Backend: Firebase, Firebase.auth, Firebase.storage, Firebase.database
Authentication: Firebase Auth
Deployment: Vercel for frontend
- Clone the Repository
git clone https://github.com/h4jack/MessFinder.git
cd MessFinder- Install Dependencies Navigate to the client directory and install dependencies:
cd client
npm install
- Configure Environment Variables Create a .env file in the client directory with the following content:
# Firebase Keys..
VITE_FIREBASE_API_KEY=your_api_key
VITE_FIREBASE_AUTH_DOMAIN=project_id.firebaseapp.com
VITE_FIREBASE_DATABASE_URL=https://project_id-default-rtdb.asia-southeast1.firebasedatabase.app
VITE_FIREBASE_PROJECT_ID=project_id
VITE_FIREBASE_STORAGE_BUCKET=project_id.appspot.com
VITE_FIREBASE_MESSAGING_SENDER_ID=your_sender_id
VITE_FIREBASE_APP_ID=1:your_sender_id:web:app_id
VITE_FIREBASE_MEASUREMENT_ID=your_management_idReplace with your_firebase_credentials and your_jwt_secret_key with your actual MongoDB URI and a secret key for JWT authentication.
- Run the Application
npm run devThe application should now be running locally.