Calculate. Learn. Act. — Your personal carbon coach and climate tutor, anytime, anywhere.
EcoSense is a Progressive Web App (PWA) that combines a household carbon footprint calculator with an AI-powered climate educator. It helps users understand, track, and reduce their carbon footprint while learning about climate change through an interactive AI tutor.
- Input household data (energy, transport, diet, waste)
- Real-time CO₂ footprint calculation
- Interactive charts and breakdowns
- "What-if" scenario simulation
- Historical tracking
- Interactive chat interface
- Personalized climate education
- Adaptive quizzes
- Voice input/output support
- Offline lesson access
- Profile management
- Progress tracking
- Achievement badges
- Social sharing
- Installable on home screen
- Offline functionality
- Push notifications
- Background sync
- Framework: Next.js (React)
- Styling: Tailwind CSS
- Charts: Chart.js
- AI: Mistral AI API
- Database: Supabase
- Authentication: Firebase Auth
- Storage: IndexedDB (offline) + Supabase (online)
- Hosting: Vercel
- Node.js 18.x or later
- npm or yarn
- Git
- Clone the repository:
git clone https://github.com/adhi982/ecosense.git
cd ecosense- Install dependencies:
npm install
# or
yarn install- Set up environment variables:
cp .env.example .env.localEdit .env.local with your API keys and configuration.
- Run the development server:
npm run dev
# or
yarn dev- Open http://localhost:3000 in your browser.
ecosense/
├── app/ # Next.js app directory
├── components/ # React components
├── lib/ # Utility functions
├── public/ # Static assets
├── styles/ # Global styles
└── types/ # TypeScript definitions
npm run dev- Start development servernpm run build- Build for productionnpm run start- Start production servernpm run lint- Run ESLintnpm run test- Run tests
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
- Climate data sources
- Open source community
- Contributors and maintainers