Track • Analyze • Reduce — Your personal AI-powered sustainability companion
CarbonMind AI is a full-stack, AI-powered sustainability dashboard that helps individuals track their daily lifestyle habits — from transportation and electricity to food, water, shopping, and flights — calculate their carbon footprint, receive intelligent AI-driven recommendations, set emission targets, earn achievement badges, and compare their impact against national and global benchmarks.
Built with Next.js 16, React 19, TypeScript, Tailwind CSS v4, and powered by Google Gemini AI for intelligent insights and a conversational climate coach, with Supabase for real-time data persistence.
|
• 🧠 AI Weekly Insights (Gemini 2.0) |
• 🎯 Carbon Score Gauge (0–100) |
• 🏅 9 Achievable Badges & Trophies |
|
• 📄 Downloadable PDF Reports |
• 👨👩👧👦 Multi-Profile Support (Family) |
Dashboard — Carbon Score Gauge, AI Insight, Charts & Stats
┌─────────────────────────────────────────────────────────────┐
│ CarbonMind AI │
│ Next.js 16 Full-Stack App │
├──────────────┬──────────────────────────────┬───────────────┤
│ Frontend │ API Routes │ Database │
│ (React 19) │ (Next.js Serverless) │ (Supabase) │
├──────────────┼──────────────────────────────┼───────────────┤
│ • Dashboard │ POST /api/ai │ • users │
│ • Analysis │ POST /api/ai-insights │ • emission_ │
│ • Goals │ │ logs │
│ • Recommend │ ┌──────────────┐ │ • chat_ │
│ • Achieve. │ │ Google │ │ messages │
│ • Leaderboard│ │ Gemini │ │ • goals │
│ • Reports │ │ 2.0 Flash │ │ • badges │
│ • Settings │ └──────────────┘ │ • ai_insights │
│ • Recap │ │ │
├──────────────┴──────────────────────────────┴───────────────┤
│ Core Engine (src/lib/) │
│ emissions.ts │ badges.ts │ benchmarks.ts │ device.ts │
│ supabase.ts │ csvExport.ts │ weeklyChallenge.ts │
└─────────────────────────────────────────────────────────────┘
User Input ──► Emission Calculator ──► Carbon Score
│ │
▼ ▼
Daily Log (Supabase) ──────────► AI Engine (Gemini)
│ │
▼ ▼
Dashboard Charts ◄──── Real Time ◄── Insights + Recommendations
│
▼
Goals • Badges • Leaderboard • Reports
| Category | Factor | Unit |
|---|---|---|
| 🚗 Car | 0.21 kg CO₂ | per km |
| 🚌 Bus | 0.10 kg CO₂ | per km |
| 🚲 Bike | 0.02 kg CO₂ | per km |
| ⚡ Electricity | 0.50 kg CO₂ | per kWh |
| 🥗 Vegetarian | 10 kg CO₂ | per week |
| 🥘 Mixed Diet | 25 kg CO₂ | per week |
| 🥩 Non-Veg | 45 kg CO₂ | per week |
| 💧 Water | 0.0003 kg CO₂ | per litre |
| 🛍️ Shopping | 0.01 kg CO₂ | per ₹ spent |
| 250 kg CO₂ | per flight/yr |
Carbon Score: max(0, min(100, round(100 - totalEmission / 2)))
| Badge | Title | How to Unlock |
|---|---|---|
| 🌟 | First Step | Save your first profile |
| 🔥 | Building Momentum | 3-day check-in streak |
| ⚡ | Week Warrior | 7-day check-in streak |
| 💪 | Habit Master | 30-day check-in streak |
| 🌿 | Eco Champion | Carbon score ≥ 80 |
| 🎯 | Goal Setter | Set an active emission goal |
| 🏆 | Target Hit | Stay under your weekly goal |
| 🥗 | Plant Powered | Vegetarian diet preference |
| 👨👩👧👦 | Family Footprint | 2+ profiles on one device |
| Category | Technology |
|---|---|
| Framework | Next.js 16 — App Router, API Routes |
| UI Library | React 19 — use client components |
| Language | TypeScript 5 |
| Styling | Tailwind CSS v4, tw-animate-css, tailwind-merge |
| Components | shadcn/ui (Radix UI primitives) |
| Icons | Lucide React |
| Charts | Recharts 3 — Area, Pie, Bar charts |
| Animations | Framer Motion 12 |
| PDF Export | jsPDF 4 |
| Database | Supabase — PostgreSQL + Realtime |
| AI / ML | Google Gemini 2.0 Flash |
| Linting | ESLint v9 + eslint-config-next |
| Package Mgr | npm |
- Node.js >= 18.x
- npm >= 9.x
- Supabase Account — for database & realtime
- Google Gemini API Key — for AI features
# Clone the repository
git clone https://github.com/YOUR_USERNAME/carbonmind-ai.git
# Navigate to project
cd carbonmind-ai
# Install dependencies
npm install
# Set up environment variables
cp .env.local.example .env.local # Then edit with your keys
# Start development server
npm run devOpen http://localhost:3000 in your browser.
Create a .env.local file in the root directory:
# Google Gemini AI (required for AI Chat & Insights)
GEMINI_API_KEY=your_gemini_api_key_here
# Supabase (required for data persistence)
NEXT_PUBLIC_SUPABASE_URL=your_supabase_project_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key| Script | Command | Description |
|---|---|---|
dev |
next dev |
Start development server |
build |
next build |
Build for production |
start |
next start |
Start production server |
lint |
eslint |
Lint the codebase |
carbonmind-ai/
├── public/ # Static assets (logo, svg icons)
├── src/
│ ├── app/ # Next.js App Router
│ │ ├── page.tsx # Dashboard (homepage)
│ │ ├── layout.tsx # Root layout (Sidebar + Header)
│ │ ├── analysis/ # Carbon analysis page
│ │ ├── goals/ # Emission goal setting
│ │ ├── recommendations/ # AI recommendations
│ │ ├── achievements/ # Badges & trophies
│ │ ├── leaderboard/ # Anonymous rankings
│ │ ├── reports/ # Downloadable reports
│ │ ├── recap/ # Monthly recap
│ │ ├── settings/ # Profile & data editor
│ │ └── api/
│ │ ├── ai/ # Climate Coach (Gemini)
│ │ └── ai-insights/ # Weekly AI Insights (cached)
│ ├── components/ # React components
│ │ ├── CarbonGauge.tsx # SVG score gauge
│ │ ├── EmissionChart.tsx # Area chart (7-day)
│ │ ├── EmissionsDonut.tsx # Pie chart breakdown
│ │ ├── CategoryComparison.tsx # Bar chart comparison
│ │ ├── WeeklyInsight.tsx # AI insight display
│ │ ├── AIAssistant.tsx # Chat widget
│ │ ├── BenchmarkComparison.tsx # India/Global benchmarks
│ │ ├── ... (21 components)
│ ├── context/ # React context
│ │ ├── UserContext.tsx # User state + profiles
│ │ └── ThemeContext.tsx # Dark/light theme
│ ├── data/ # Mock data (placeholder)
│ └── lib/ # Utilities
│ ├── emissions.ts # Core calculation engine
│ ├── supabase.ts # DB client + types
│ ├── badges.ts # Badge definitions
│ ├── useBadges.ts # Badge evaluation hook
│ ├── benchmarks.ts # Reference emission data
│ ├── csvExport.ts # CSV download
│ ├── device.ts # Device ID generation
│ ├── ToastContext.tsx # Toast notification system
│ ├── weeklyChallenge.ts # Weekly challenge logic
│ └── useRealtimeUser.ts # Supabase Realtime hook
├── components/ui/ # shadcn/ui primitives
├── docs/ # Documentation assets
├── frontend/ # Future standalone frontend
├── backend/ # Future FastAPI backend
├── .env.local # Environment variables
├── AGENTS.md # Next.js version info
├── next.config.ts # Next.js configuration
├── tailwind.config.ts # Tailwind configuration
└── package.json # Dependencies & scripts
| Status | Feature |
|---|---|
| ✅ | Dashboard with live analytics & charts |
| ✅ | Carbon footprint calculator |
| ✅ | AI-powered weekly insights (Gemini) |
| ✅ | AI Climate Coach chat assistant |
| ✅ | Personalized recommendations |
| ✅ | Weekly sustainability challenges |
| ✅ | Goal setting & progress tracking |
| ✅ | Badge/achievement gamification |
| ✅ | Anonymous leaderboard |
| ✅ | Dark/light theme |
| ✅ | Multi-profile support (family) |
| ✅ | Offline detection |
| ✅ | Report exports (PDF, TXT, CSV) |
| ✅ | Monthly recap |
| ✅ | Streak tracking |
| ✅ | Benchmark comparison (India/Global) |
| 🔄 | Authentication system |
| 🔄 | Advanced Supabase integration |
| 🔄 | Google Maps route emission tracking |
| 🔄 | Carbon offset marketplace |
| 🔄 | Mobile app (React Native) |
| 🔄 | FastAPI Python backend |
| 🔄 | Social sharing & community challenges |
| 🔄 | Gamification leaderboards & seasons |
Contributions are welcome! See CONTRIBUTING.md for the full guide.
- Fork the repository
- Create a feature branch (
git checkout -b feature/your-idea) - Make changes and run
npm run buildto verify - Commit and push
- Open a Pull Request
Open source under the MIT License — feel free to use, modify, and contribute.
- Next.js — The React framework
- shadcn/ui — Beautifully designed components
- Supabase — Open source Firebase alternative
- Google Gemini — AI capabilities
- Recharts — Composable charting library
- Lucide Icons — Beautiful icon set
- Framer Motion — Animation library
