Your Ultimate Digital Mess Companion for SRM Students
MessMate is a modern, feature-rich web application designed to revolutionize the dining experience for students at SRM University. Built with the Nebula Design System, it combines aesthetic excellence with practical utility, offering real-time menu updates, meal tracking, community ratings, and a touch of fun with our signature "Flirty Notifications".
- Nebula Design System: A custom-built design language featuring glassmorphism, vibrant gradients, and smooth animations.
- Dark/Light Mode: Seamless theme switching with system preference detection.
- Responsive Layout: Optimized for all devices, from mobile phones to desktops.
- Meal Alerts: Get notified 15 minutes before every meal.
- Flirty Messages: Choose your vibe! Notifications come in English, Hinglish, Tenglish, Tanglish, and Malnglish.
- "Hey handsome, Chicken Biryani is waiting!"
- "Machan, Dosa ready! Mass kaatrom."
- Customizable: Toggle notifications and select your preferred language style in Settings.
- Live Menu: Real-time updates on what's serving in Sannasi and M-Block messes.
- Meal Schedule: Accurate timings for Breakfast, Lunch, Snacks, and Dinner.
- Favorites: Mark items as favorites and get highlighted alerts.
- Dietary Filters: Easily filter for Veg, Non-Veg, or Egg items.
- Food Ratings: Rate dishes and see what the community thinks.
- Live Activity Feed: See what others are eating and rating in real-time.
- Quick Stats: View popular dishes and average ratings at a glance.
- Installable: Add MessMate to your home screen for a native app-like experience.
- Offline Mode: Access the menu even without an internet connection.
- Frontend: React + Vite
- Styling: Tailwind CSS
- Animations: Framer Motion
- State Management: Zustand
- Icons: Lucide React
- Backend/Services: Firebase (Firestore, Analytics)
- PWA: Vite PWA Plugin
Follow these steps to run MessMate locally on your machine.
- Node.js (v16 or higher)
- npm or yarn
-
Clone the repository
git clone https://github.com/gowthamrdyy/Messmate.git cd Messmate -
Install dependencies
npm install
-
Start the development server
npm run dev
-
Open in browser Navigate to
http://localhost:5173(or the port shown in your terminal).
| Home Screen | Menu View | Settings |
|---|---|---|
| (Add screenshot) | (Add screenshot) | (Add screenshot) |
Contributions are welcome! If you have ideas for new features or improvements:
- Fork the repository.
- Create your feature branch (
git checkout -b feature/AmazingFeature). - Commit your changes (
git commit -m 'Add some AmazingFeature'). - Push to the branch (
git push origin feature/AmazingFeature). - Open a Pull Request.
This project is licensed under the MIT License - see the LICENSE file for details.
Gowthamrdyy
Made with ❤️ for SRMites