GreenSwap is a simple web platform that promotes sustainability by enabling users to exchange or donate reusable items instead of throwing them away.
Built with Node.js + Express (backend) and HTML/CSS/JS (frontend), it provides a minimal, easy-to-use solution for item swapping.
- Add items (name, category, price, contact details)
- View all available items in a clean UI
- Data stored in a local JSON file (no external DB required)
- Runs locally on your computer with npm start
GreenSwap/
├── data/
│ └── items.json # Stores added items
├── public/
│ ├── index.html # Main UI
│ ├── style.css # Styling
│ └── script.js # Frontend logic
├── server.js # Backend server
├── package.json # Dependencies & scripts
└── README.md # Project info
- Clone the repo
git clone https://github.com/ciril7/GreenSWAP-Demo-web.git cd GreenSWAP-Demo-web
Install dependencies
npm install
Run the app
npm start
Open in browser: 👉 http://localhost:5000
👨💻 Author
Ciril C Reji Hackathon Project — GreenSwap 🌱♻️
📜 License
This project is open-source and free to use.
✅ Just create a new file named README.md in your project folder, paste this in, save, and then commit & push again to GitHub.
Would you like me to also give you the exact Git commands to add the README and push it in one shot?