Laundrify is a modern, full-stack web application built to eliminate the chaos of hostel laundry management. It provides students with a seamless digital platform to submit, track, and manage their laundry, removing the hassle of paper slips and reducing the chances of losing clothes.
Now available as a Dockerized setup β so you can run both frontend and backend instantly using Docker Compose!
- π± Digital Laundry Slips β Simple, intuitive form to digitally add clothes. No more paper slips!
- π€ Smart Roommate Sync β Automatically merges laundry slips from all roommates into a master list for the room.
- π Live Dashboard β Real-time overview of all submissions with a combined summary of items.
- βοΈ Inline Editing & Deletion β Edit quantities or delete entries directly from the dashboard.
- π Secure Authentication β Login/Signup powered by JWT for complete data security.
- π± Responsive Design β Premium UI/UX optimized for desktop and mobile.
- π³ Docker Support β Run the full app stack (frontend, backend, and MongoDB) with one command.
- π Fully Responsive Website β Works smoothly across desktops, tablets, and mobile devices.
| Category | Technology |
|---|---|
| Frontend | React, React Router, Tailwind CSS, Axios |
| Backend | Node.js, Express.js |
| Database | MongoDB with Mongoose |
| Auth | JWT (JSON Web Tokens), bcrypt.js |
| DevOps | Docker, Docker Compose |
You can set up Laundrify in two ways:
- π§© Traditional Setup (Node + npm)
- π³ Docker Setup (Recommended for developers)
- Docker Desktop or Docker Engine + Docker Compose plugin installed.
# 1οΈβ£ Clone the repository
git clone https://github.com/VANSH-THAPAR/Laundrify.git
cd Laundrify
# 2οΈβ£ Build and start all services
docker compose up --build