FairBasket is an innovative, open-source e-commerce platform designed to revolutionize the grocery supply chain by promoting transparency, affordability, and accessibility. Built by Team Bugsquashers, FairBasket leverages artificial intelligence and a user-centric marketplace to empower wholesalers, retailers, and consumers with fair pricing, data-driven insights, and seamless online shopping experiences.
🔗 FairBasket Demo (Coming Soon!)
- 📘 Project Documentation
- 🧾 Development Setup Guide
- 👥 Contributing Guidelines
- 🗂️ Wiki
- 🧭 DevLog
- ✅ Trello Board
📈 Coming Soon
| 👤 Name | 🎯 Role | 💻 GitHub | |
|---|---|---|---|
| sahilaf | Frontend Developer (Team Lead) | sahilaf | |
| Sajidcodecrack | Backend Developer | Sajidcodecrack | |
| AJFShuvo | Tester/Backend Developer | AJFShuvo | |
| moshiuzzaman | Mentor | moshiuzzaman |
FairBasket is a full-featured e-commerce platform built using React, Node.js, and MongoDB, designed to disrupt grocery supply chains by ensuring transparency and fairness. It integrates AI-powered product recommendations, market analytics, and a user-generated marketplace, providing a scalable solution for wholesalers, retailers, and consumers. The platform is developed using modern tools like Vite, Tailwind CSS, and FastAPI, following best practices for performance and maintainability.
- Suggests groceries tailored to user budgets and preferences using ML.
- Enhances satisfaction and boosts conversion rates.
- 24/7 assistance via an NLP-powered chatbot.
- Scalable for future AI integrations like predictive analytics.
- Insights into trends, sales, and customer behavior.
- Empowers sellers with data-driven decisions and visual dashboards.
- Users can create and manage online shops with ease.
- Fosters entrepreneurship and democratizes e-commerce.
- Real-time pricing transparency
- Profit analytics and margin tracking
- Global reach & multi-language support
- Real-time delivery tracking system
- AI recipe assistant (grocery list via food image)
FairBasket aims to:
✅ Break grocery market monopolies
✅ Ensure fair pricing
✅ Promote accessibility and transparency
✅ Empower small businesses and consumers alike
“FairBasket: Building a transparent, equitable, and innovative grocery ecosystem.”
| User Type | Use Case |
|---|---|
| Wholesalers | Sell bulk goods, access market trends, optimize pricing |
| Retailers | Source fresh goods, manage shops, leverage analytics |
| Consumers | Shop with personalized recommendations, fair pricing |
FairBasket is redefining the grocery supply chain by:
- ✅ Eliminating price manipulation
- ✅ Empowering small businesses
- ✅ Ensuring fair pricing
- ✅ Promoting sustainable logistics
- Node.js (v16+)
- npm or yarn
- MongoDB (local/cloud)
- Python (for FastAPI)
- Git
git clone https://github.com/Learnathon-By-Geeky-Solutions/bugsquashers.git
cd fairbasket📦 Install Dependencies
npm install
# or
yarn installnpm run dev
# or
yarn devOpen http://localhost:3000 in your browser to view the app.
🛠 Backend Setup (FastAPI)
cd backend
pip install -r requirements.txt
uvicorn main:app --reload- Branching: Use
feature/<feature-name>for new features - Commits: Write descriptive messages (e.g.,
Add AI recommendation engine) - Pull Requests: Submit PRs to the
mainbranch for review - Testing: Run tests using
npm test(powered by Vitest) - CI/CD: Automated via GitHub Actions
📖 Refer to CONTRIBUTING.md for full guidelines.
Screenshots coming soon...
We welcome contributions from everyone! To get started:
- Fork the repository
- Create a feature branch
git checkout -b feature/your-featureCommit changes:
git commit -m "Add your feature"Push to GitHub:
git push origin feature/your-featureOpen a Pull Request
See CONTRIBUTING.md and CODE_OF_CONDUCT.md for more.
📜 License FairBasket is licensed under the MIT License. See LICENSE for more information.
📬 Contact Email: [email protected]
GitHub Issues: Report a bug or request a feature