🌍 Eco Track Bangladesh

Empowering 160 million Bangladeshis to build a sustainable future — one action at a time.

Quick Start • Features • Tech Stack • Contributing • License

---

🌊 The Challenge

Bangladesh is one of the world's most climate-vulnerable nations:

• 🌊 70% of the country is less than 1 meter above sea level
• 🌡️ Increasing cyclones, floods, and extreme weather events
• 🏭 Rapid urbanization driving air quality issues in major cities
• ♻️ Rivers like Buriganga among the most polluted globally

Eco Track Bangladesh transforms this challenge into an opportunity — giving citizens the tools, knowledge, and community to drive meaningful environmental change.

---

✨ Features

🧮 Carbon Calculator Track your daily emissions from electricity, transportation, and waste. Visualize trends and get personalized recommendations. 📚 Interactive Quizzes Learn about environmental topics with gamified quizzes. Multiple difficulty levels with detailed explanations. 🎯 Daily Challenges Build sustainable habits with curated eco-challenges designed for the Bangladeshi context.

👥 Community Platform Share tips, learn from fellow citizens, and build a network of eco-conscious individuals. 🗺️ Eco Locations & Events Discover recycling centers, parks, and upcoming environmental events across Bangladesh. 🌳 Tree Planting Tracker Plant trees virtually with real-world impact tracking. Each tree absorbs 20-50 kg CO₂/year.

🏆 Gamification & Progress

• Badges & Achievements — Earn rewards for completing challenges and reaching milestones
• Leaderboards — Foster friendly competition in your community
• Personal Dashboard — Comprehensive analytics of your environmental impact
• Multilingual Support — Available in English and Bengali (বাংলা)

---

🚀 Quick Start

Prerequisites

• Node.js v18+ or Bun
• Backend API — EcoTrack Backend (separate repository)

Installation

# Clone the repository
git clone https://github.com/yourusername/ecotrack_bd.git
cd ecotrack_bd

# Install dependencies
npm install
# or
bun install

# Configure environment
cp .env.example .env
# Edit .env with your API URL

# Start development server
npm run dev
# or
bun dev

Environment Variables

Create a .env file in the root directory:

VITE_API_URL=http://localhost:3000/api

Variable	Description	Default
VITE_API_URL	Backend API base URL	http://localhost:3000/api

---

🛠️ Tech Stack

Layer	Technology	Purpose
UI Library	React 18	Component-based UI
Language	TypeScript	Type safety
Build Tool	Vite	Fast development & bundling
Styling	Tailwind CSS	Utility-first CSS
Routing	React Router 7	Client-side navigation
Charts	Recharts	Data visualization
Maps	React Leaflet	Interactive maps
Animations	Framer Motion	Smooth animations
Icons	Lucide React	Beautiful icon set

---

📁 Project Structure

src/
├── components/          # Reusable UI components
│   ├── Navbar.tsx      # Navigation bar
│   ├── Footer.tsx      # Site footer
│   └── ...
├── contexts/           # React context providers
│   ├── AuthContext.tsx # Authentication state
│   ├── ThemeContext.tsx# Dark/light mode
│   └── LanguageContext.tsx # i18n support
├── pages/              # Route pages
│   ├── Home.tsx        # Landing page
│   ├── Dashboard.tsx   # User dashboard
│   ├── Calculator.tsx  # Carbon calculator
│   └── ...
├── lib/                # Utilities & API
│   └── api.ts          # API client functions
└── utils/              # Helper functions

---

🔌 API Endpoints

The frontend connects to a REST API with these main endpoints:

Endpoint	Description
/api/auth/*	Authentication (signup, login, verify)
/api/profile	User profile management
/api/carbon	Carbon footprint tracking
/api/challenges	Daily eco-challenges
/api/community/*	Posts, comments, likes
/api/quiz/*	Quiz questions & attempts
/api/badges	User achievements
/api/eco-locations	Eco-friendly places
/api/eco-events	Environmental events
/api/planting/*	Tree planting system
/api/leaderboard	User rankings

---

🤝 Contributing

We welcome contributions from everyone! Here's how you can help:

1. Fork the repository
2. Create a feature branch: git checkout -b feature/amazing-feature
3. Commit your changes: git commit -m 'Add amazing feature'
4. Push to the branch: git push origin feature/amazing-feature
5. Open a Pull Request

Ways to Contribute

Area	Description
🌐 Localization	Improve Bengali translations
🎨 UI/UX	Enhance design and accessibility
📝 Documentation	Improve guides and tutorials
🐛 Bug Fixes	Report and fix issues
✨ Features	Propose and implement new features
🧪 Testing	Add unit and integration tests

---

🌟 Impact Vision

📊 Short-term 1,000+ active users 5,000+ quiz attempts 100+ trees planted

🚀 Medium-term 500+ tons CO₂ reduced 10,000+ registered users 50+ eco-events

🌍 Long-term National recognition Policy influence 100,000+ users

---

📄 License

This project is licensed under the MIT License — see the LICENSE file for details.

---

🙏 Acknowledgments

• The resilient people of Bangladesh 🇧🇩
• Environmental organizations protecting our natural resources
• The amazing open-source community
• All contributors who make this project better

---

Built with 💚 for a greener Bangladesh

"The best time to plant a tree was 20 years ago. The second best time is now."

Report Bug • Request Feature