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 verdi-go# 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.
If you want to use features that require external APIs (like Air Quality monitoring), navigate to the frontend directory and set up environment variables:
cd frontend
cp .env.example .envOpen the newly created frontend/.env file and replace the placeholder values with your actual API keys.
Required for Air Quality feature:
VITE_OPENWEATHER_API_KEY: Get your free API key from OpenWeatherMap
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