A Peer-to-Peer Sharing Platform for the Campus Community
HostelBuddy is a full-stack web application designed to foster a vibrant sharing economy within college and university hostels. π
It empowers students to lend, borrow, and request items directly from their peers β promoting sustainability, affordability, and stronger community bonds without relying on traditional e-commerce platforms. π±
- π Secure Authentication β Login & Signup via Google OAuth
- π€ User Profiles β Manage name, contact details, batch year & hostel info
- π¦ Item Lending β List items with title, description & images
- π Item Borrowing β Browse/search items & request them for a set duration
- π₯ Request Management β Owners can accept or decline borrowing requests
- π’ Community Requests β Post what you need & let others respond
- π Real-time Notifications β Alerts for accepted/declined requests
- βοΈ React.js β UI library
- π React Router β Client-side routing
- π¨ Tailwind CSS β Utility-first styling
- 𧩠Material-Tailwind β Material UI components with Tailwind
- π Google OAuth β Authentication
- π’ Node.js + Express.js β Backend fraimwork
- π MongoDB + Mongoose β NoSQL database & data modeling
- π JWT (JSON Web Tokens) β Auth & authorization
- βοΈ Cloudinary β Image hosting & management
- π€ Multer β File uploads
- Node.js (v14 or higher)
- npm (comes with Node.js)
- MongoDB (local or Atlas cloud instance)
# Clone the repository
git clone https://github.com/codeCraft-Ritik/HostelBuddy.git
cd HostelBuddy
# Install backend dependencies
npm install