🌱 EcoBloom

Your Personal Sustainability Companion
Track your carbon footprint, discover eco-friendly businesses, and learn to live more sustainably.

---

📱 About

EcoBloom is a fully functional portfolio demo showcasing how a real-world sustainability app would work. Built with Jetpack Compose and following MVVM + Repository architecture, this project demonstrates modern Android development practices while simulating a complete user experience for tracking environmental impact, discovering sustainable businesses in Kenya, and learning about eco-friendly practices.

🎓 Portfolio Project: This app is a working demonstration of my Android development skills. It uses local data (Room database) to simulate all features a production sustainability app would offer, including carbon tracking, business discovery, educational content, and gamification — all running fully offline without requiring backend services.

🎯 SDG Alignment

EcoBloom directly supports the United Nations Sustainable Development Goals:

SDG	Goal	How EcoBloom Contributes
🏙️ SDG 11	Sustainable Cities & Communities	Promotes local sustainable businesses and eco-friendly transportation
♻️ SDG 12	Responsible Consumption & Production	Tracks consumption patterns and encourages waste reduction
🌍 SDG 13	Climate Action	Measures carbon footprint and incentivizes carbon-saving activities

---

✨ Features

🏠 Dashboard

• Carbon Footprint Overview: Real-time visualization of your environmental impact
• Quick Actions: Log activities with one tap
• Sustainability Score Card: See your overall eco-warrior rating
• Progress Tracking: Weekly and monthly carbon savings at a glance

📊 Activity Tracking

• Multiple Activity Types: Transport, food, energy, shopping, recycling
• Smart Calculations: Accurate carbon impact using verified emission factors
• Activity History: Complete log with filtering and search
• Streak Tracking: Maintain daily logging streaks for bonus rewards

🏪 Business Directory

• Sustainable Business Discovery: Find eco-friendly businesses near you
• Sustainability Scores: 1–5 leaf rating system based on practices
• Categories: Restaurants, cafés, groceries, fashion, transportation, energy & more
• Detailed Profiles: Certifications, practices, contact info, and reviews
• Kenyan Focus: Curated businesses across Nairobi, Mombasa, Kisumu, and beyond

📚 Learn Hub

• Curated Articles: Expert-verified content on sustainability topics
• Sustainability Tools: Calculators and interactive learning tools
• SDG Tagging: Content aligned with specific sustainability goals
• Kenyan Context: Local authors covering topics like M-KOPA solar, Lake Victoria conservation, and the Green Belt Movement

🏆 Gamification

• Achievements & Badges: Unlock rewards for sustainable actions
• Experience Points (XP): Level up your eco-warrior status
• Tiered Rewards: Bronze, Silver, Gold, and Platinum badges

👤 Profile & Settings

• Personal Statistics: Lifetime carbon savings and activity counts
• Editable Profile: Display name, bio, location, and photo
• Notification Preferences: Reminders and updates
• Theme Support: Light, dark, and system-default modes

---

🛠️ Tech Stack

Core

Technology	Purpose
Kotlin 2.0.21	Primary programming language
Jetpack Compose (BOM 2024.11.00)	Modern declarative UI toolkit
Material 3	Design system with dynamic theming
Coroutines & Flow	Asynchronous programming & reactive streams

Architecture & DI

Technology	Purpose
MVVM + Repository	Presentation & data layer pattern
Hilt 2.52 (KSP)	Dependency injection
Navigation Compose 2.8.5	Screen navigation

Data & Storage

Technology	Purpose
Room 2.6.1 (KSP)	Local SQLite database with Flow support
DataStore	User preferences storage
Gson	JSON serialization for Room type converters

Networking & Location

Technology	Purpose
Retrofit 2.11.0 + OkHttp	HTTP client (ready for API integration)
Google Maps + Maps Compose	Map display and location services
Coil 2.7.0	Image loading and caching

Utilities

Technology	Purpose
WorkManager	Background task scheduling
Timber	Logging
Splash Screen API	Android 12+ splash screen

---

🏗️ Architecture

EcoBloom follows MVVM + Repository architecture with separation between presentation and data layers:

┌─────────────────────────────────────────────────────────────┐
│                    PRESENTATION LAYER                        │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────┐  │
│  │   Screens   │  │  ViewModels │  │     Components      │  │
│  │  (Compose)  │  │ (StateFlow) │  │  (20+ Reusable UI)  │  │
│  └─────────────┘  └─────────────┘  └─────────────────────┘  │
├─────────────────────────────────────────────────────────────┤
│                      DOMAIN LAYER                            │
│         ┌──────────────────────────────────────┐             │
│         │  Enums & Type Definitions            │             │
│         │  ActivityType, BusinessCategory,      │             │
│         │  AchievementType, CarbonCategory      │             │
│         └──────────────────────────────────────┘             │
├─────────────────────────────────────────────────────────────┤
│                       DATA LAYER                             │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────┐  │
│  │    Room DB   │  │  DataStore  │  │    Repositories     │  │
│  │  (7 tables)  │  │ (Prefs)    │  │  (6 repositories)   │  │
│  └─────────────┘  └─────────────┘  └─────────────────────┘  │
└─────────────────────────────────────────────────────────────┘

Key Architectural Decisions

• Unidirectional Data Flow: State flows down via StateFlow, events flow up via callbacks
• Single Source of Truth: Room database as the primary data source
• Reactive Streams: Kotlin Flow for all reactive data updates
• Immutable State: Data classes with copy() for state updates
• Pre-seeded Data: DataSeeder populates demo content on first launch

---

📁 Project Structure

app/src/main/java/com/kodinova/ecobloom/
├── 📂 data/
│   ├── 📂 components/        # Home screen widget composables
│   ├── 📂 local/
│   │   ├── 📂 converters/    # Room type converters (Gson)
│   │   ├── 📂 dao/           # 7 Room Data Access Objects
│   │   ├── 📂 entity/        # 7 database entities
│   │   ├── 📂 model/         # Query result models
│   │   └── EcoBloomDatabase.kt
│   ├── 📂 model/             # Data models (NewsItem, WeatherData)
│   ├── 📂 repository/        # 6 repository implementations
│   └── 📂 ui/                # UI state classes & screen models
│
├── 📂 di/                    # Hilt DI modules
│   ├── AppModule.kt
│   ├── DatabaseModule.kt
│   └── RepositoryModule.kt
│
├── 📂 domain/
│   └── 📂 model/             # Domain enums (ActivityType, BusinessCategory, etc.)
│
├── 📂 presentation/
│   ├── 📂 components/        # 20 reusable UI components
│   ├── 📂 navigation/        # Route definitions
│   ├── 📂 screens/           # 15 screen composables
│   ├── 📂 theme/             # Material 3 theming (Color, Type, Shape, Spacing)
│   └── 📂 viewmodel/         # 11 ViewModels with state management
│
├── 📂 util/                  # Utilities
│   ├── CarbonCalculator.kt   # Emission factor calculations
│   ├── Constants.kt          # App-wide constants
│   ├── DataSeeder.kt         # Initial data population
│   ├── DateFormatter.kt      # Date formatting helpers
│   ├── LocationUtils.kt      # Location utilities
│   └── StringValidators.kt   # Input validation
│
├── EcoBloom.kt               # Main NavHost & Scaffold
└── MainActivity.kt           # Single activity entry point

---

🚀 Getting Started

Prerequisites

• Android Studio: Ladybug (2024.2.1) or newer
• JDK: 17 or higher
• Android SDK: API 26+ (Android 8.0 Oreo)
• Kotlin: 2.0.21

Installation

1. Clone the repository

   git clone https://github.com/muchaisam/ecobloom.git
   cd ecobloom

2. Open in Android Studio

   • File → Open → Select the project folder
   • Wait for Gradle sync to complete

3. Build and Run

   ./gradlew assembleDebug

   Or use the Run button in Android Studio

   Note: The app runs fully offline — no API keys or backend services required.

Demo Mode

The app includes a demo user (user_demo_001) with pre-seeded data for testing:

• Sample activities and carbon tracking history
• Pre-defined achievements
• Curated sustainable businesses and educational articles

---

📸 Screenshots

     

     

_{Dashboard • Weekly Impact • Activity Log • Directory • Learn Hub • Profile}

---

🧮 Carbon Calculation Methodology

EcoBloom uses verified emission factors to calculate carbon impact:

Activity	Emission Factor	Source
Car (petrol)	0.21 kg CO₂/km	EPA
Matatu/Bus	0.089 kg CO₂/km	IPCC
Boda Boda	0.103 kg CO₂/km	Kenya Transport
Beef meal	6.61 kg CO₂/meal	Our World in Data
Vegetarian meal	1.7 kg CO₂/meal	Our World in Data
Electricity (Kenya)	0.35 kg CO₂/kWh	Kenya Power
Recycling (plastic)	−1.5 kg CO₂/kg	EPA

Carbon savings are calculated as the difference between typical consumption and sustainable alternatives.

---

🤝 Contributing

Contributions are welcome! Please follow these steps:

1. Fork the repository
2. Create a feature branch

   git checkout -b feature/amazing-feature

3. Follow code standards
   • Use existing patterns in the codebase
   • Follow Kotlin coding conventions
   • Write meaningful commit messages
4. Submit a Pull Request

Code Style

• Follow Kotlin Coding Conventions
• Use meaningful names for variables, functions, and classes
• Keep composables small and focused

---

📄 License

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

---

🙏 Acknowledgments

• Wangari Maathai — Inspiration for environmental conservation in Kenya
• M-KOPA — Pioneering sustainable energy access in Africa
• Material Design 3 — Design system and components
• Jetpack Compose — Modern Android UI toolkit

---

📞 Contact

• Project Link: github.com/muchaisam/ecobloom
• Issues: Report a bug

---

🌍 Together, we can make a difference. One sustainable choice at a time. 🌱

Made with 💚 in Kenya