VerdiGo is a comprehensive environmental impact platform that empowers users to track, reduce, and offset their carbon footprint while promoting sustainable living practices.
- 🧮 Carbon Footprint Calculator - Calculate your environmental impact across home, travel, food, and waste
- 🌬️ Air Quality Monitoring (AirBuddy) - Real-time air quality data and health recommendations
- 🗺️ Green Lane Navigation - Eco-friendly route planning and green transportation options
- 🥬 Local Harvest - Discover local, sustainable food sources and farmers markets
- ♻️ WasteLess - Waste reduction tips, recycling guidance, and sustainability practices
- 📊 Interactive Dashboard - Comprehensive overview of your environmental impact
- 🗺️ Interactive Maps - Location-based environmental data and services
Frontend:
- React 19.1.0 with Vite
- React Router for navigation
- Tailwind CSS for styling
- Radix UI components
- Leaflet for interactive maps
- Recharts for data visualization
Backend:
- Node.js with Express 5.1.0
- CORS for cross-origin requests
- Multer for file uploads
- Dotenv for environment management
- Node.js (v18.0.0 or higher)
- npm or yarn package manager
- Git
git clone https://github.com/Meghali54/Verdigo_Eco-friendly_Project.git
cd Verdigo_Eco-friendly_Project# Install root dependencies
npm install
# Install frontend dependencies
cd frontend
npm install
# Install backend dependencies
cd ../backend
npm install-
Navigate to the backend directory:
cd backend -
Copy the environment template file:
cp .env.example .env
-
Open the newly created .env file and replace the placeholder values with your actual MongoDB URI and secret keys.
Terminal 1 - Backend (Port 3001):
cd backend
npm run dev
# or
PORT=3001 node index.jsTerminal 2 - Frontend (Port 3000):
cd frontend
npm run devNavigate to http://localhost:3000 to see the application.
verdi-go/
├── backend/ # Express.js backend
│ ├── index.js # Main server file
│ ├── package.json # Backend dependencies
│ └── .env.example # Environment variables template
├── frontend/ # React frontend
│ ├── src/
│ │ ├── components/ # Reusable UI components
│ │ ├── pages/ # Page components
│ │ ├── contexts/ # React contexts
│ │ ├── hooks/ # Custom hooks
│ │ ├── lib/ # Utility libraries
│ │ ├── types/ # Type definitions
│ │ └── utils/ # Utility functions
│ ├── public/ # Static assets
│ └── package.json # Frontend dependencies
├── package.json # Root package.json
└── vercel.json # Deployment configuration
Calculate your environmental impact across multiple categories:
- Home Energy Usage - Electricity, heating, and cooling
- Transportation - Car, public transit, flights
- Food Consumption - Diet choices and food waste
- Waste Generation - Recycling and disposal habits
- Real-time air quality index (AQI) data
- Health recommendations based on air quality
- Historical air quality trends
- Location-based alerts
- Eco-friendly route suggestions
- Carbon footprint comparison between transport modes
- Electric vehicle charging station locations
- Public transportation integration
- Farmers market locations and schedules
- Local sustainable food producers
- Seasonal produce availability
- Community garden locations
We welcome contributions from the community! Please see our Contributing Guidelines for details on how to get started.
- 🐛 Bug Reports - Found a bug? Let us know!
- ✨ Feature Requests - Have an idea? We'd love to hear it!
- 🔧 Code Contributions - Help us build new features
- 📚 Documentation - Improve our docs
- 🧪 Testing - Help us test new features
- Follow ESLint configuration
- Use meaningful variable and function names
- Write comments for complex logic
- Follow React best practices
We use conventional commits:
feat: add new carbon calculator component
fix: resolve map rendering issue
docs: update installation instructions
style: format code with prettier
Found a bug? Please create an issue with:
- Clear description of the problem
- Steps to reproduce
- Expected vs actual behavior
- Screenshots if applicable
- System information (OS, browser, Node version)
- Mobile App - React Native mobile application
- API Integration - External environmental data APIs
- Gamification - Achievement system and challenges
- Community Features - User forums and sharing
- AI Recommendations - Personalized sustainability suggestions
- Offset Marketplace - Carbon offset purchasing platform
This project is licensed under the MIT License - see the LICENSE file for details.
- Your Name - Initial work - YourGitHub
- Thanks to all contributors who help make this project better
- Environmental data providers and APIs
- Open source community for the amazing tools and libraries
See full list of contributor contribution Contribution Graph
If you find this project helpful, please consider giving it a star! ⭐
Made with 💚 for a sustainable future