Skip to content

Latest commit

 

History

30 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🌱 CarbonTrack

Track your footprint. Understand your impact. Make every choice count.

CarbonTrack is a full-stack sustainability platform designed to transform everyday activities into meaningful environmental insights.

From the way you travel to the food you eat, the electricity you consume, and the things you buy — CarbonTrack helps you understand how your daily choices contribute to your carbon footprint and guides you toward a more sustainable lifestyle.

Small choices create patterns. Patterns create habits. And habits can change the world. 🌍


✨ Why CarbonTrack?

Our carbon footprint is built from hundreds of ordinary decisions that often go unnoticed.

CarbonTrack turns those invisible emissions into something you can see, understand, track, and improve.

Instead of simply telling users to "be sustainable", CarbonTrack gives them:

  • 📊 Data to understand their environmental impact
  • 💡 Personalised insights based on their own activities
  • 🎯 Goals that turn intentions into measurable progress
  • 🔥 Daily streaks that encourage consistency
  • 🏆 Badges & achievements that make sustainability rewarding
  • 🌱 Recommendations focused on their highest-impact activities
  • 👥 Community benchmarking to encourage positive competition
  • 📈 Interactive analytics to make progress easy to understand

CarbonTrack isn't just a carbon calculator.

It's a companion for building better habits.


🌿 What Makes CarbonTrack Special?

We wanted sustainability tracking to feel less like filling out a spreadsheet and more like using a modern, engaging product.

🌌 A Living Landing Page

The CarbonTrack landing experience features a dynamic live background designed to create an immersive environmental atmosphere from the moment users enter the application.

🧭 Guided User Experience

A built-in interactive walkthrough tour introduces new users to the platform and helps them understand the important features without making them figure everything out themselves.

🔥 Daily Streaks

Consistency matters.

Users can build daily activity-logging streaks, turning sustainability into a habit rather than a one-time interaction.

🎯 Goals That Keep You Moving

Users can create sustainability goals, monitor their progress, and understand whether they are moving in the right direction.

🤖 Smarter Personalisation

CarbonTrack analyses user activity and footprint patterns to provide personalised recommendations and insights, helping users focus on the areas where their actions can make the greatest difference.


🌎 Core Features

👤 User Profiles & Authentication

  • Secure user authentication
  • JWT-based security
  • User profile management
  • Personal sustainability preferences
  • Role-based access
  • Secure activity ownership

🚗 Activity Logging

Users can record activities across major everyday categories:

🚙 Transport

  • Car journeys
  • Flights
  • Public transportation
  • Other mobility activities

⚡ Electricity

  • Electricity consumption
  • Energy-related activities

🍽️ Food

  • Meal types
  • Servings
  • Food-related activities

🛍️ Shopping

  • Product categories
  • Spending-based activities

Each activity is processed through the emission calculation engine to estimate its kg CO₂e impact.


🧮 Carbon Emission Engine

At the heart of CarbonTrack is a configurable emission calculation engine.

Instead of hardcoding emission values into application logic, CarbonTrack stores emission factors in the database.

When a user logs an activity:

Activity
   ↓
Activity Type + Quantity + Unit
   ↓
Emission Factor
   ↓
Carbon Calculation
   ↓
kg CO₂e
   ↓
Analytics & Insights

This makes the system flexible and allows emission factors to be updated without rewriting the core business logic.


📊 Sustainability Analytics

CarbonTrack transforms individual activity logs into meaningful environmental analytics.

Users can explore:

  • 🌱 Today's footprint
  • 📅 Daily footprint
  • 📈 Weekly trends
  • 🗓️ Monthly footprint
  • 🥧 Category-wise emissions
  • 📊 Historical comparisons
  • 🎯 Progress against sustainability goals
  • 🌍 Relative environmental performance

The dashboard is designed to make complex environmental data understandable at a glance.


🎯 Goals & Progress Tracking

Sustainability becomes much easier when you have something concrete to work toward.

Users can:

  • Set personal reduction goals
  • Define a target reduction percentage
  • Track progress over time
  • Monitor their current footprint
  • Understand whether they are on track
  • See the reduction needed to achieve their target
  • Receive relevant encouragement and insights

Goal → Progress → Consistency → Achievement


🔥 Streaks, Badges & Achievements

CarbonTrack introduces gamification to make sustainable behaviour more engaging.

Users can earn achievements for milestones such as:

  • 🔥 Maintaining logging streaks
  • 🎯 Achieving sustainability goals
  • 🌱 Reducing their carbon footprint
  • 🏆 Reaching important environmental milestones

These achievements become part of the user's sustainability journey.


💡 Personalised Recommendations

Not every user's footprint looks the same.

CarbonTrack analyses the user's activities and identifies their highest-impact areas, allowing the platform to generate recommendations that are relevant to their actual behaviour.

Instead of:

"Use less energy."

CarbonTrack aims to provide guidance closer to:

"Your electricity consumption is currently one of your largest emission sources. Reducing usage during high-consumption periods could help lower your footprint."

The goal is simple:

Don't give users more information.

Give them information they can actually act on.


🏆 Community Leaderboard

Sustainability can be a little more motivating when the journey isn't completely solitary.

CarbonTrack includes a community-oriented leaderboard where users can compare their progress while keeping personal identity protected.

Users can explore:

  • 🏅 Sustainability rankings
  • 🎖️ Earned badges
  • 🌱 Category strengths
  • 💡 Habit-based insights
  • 📊 Relative performance

The objective isn't simply to compete.

It's to inspire better habits.


🏢 Organisation & Sustainability Analytics

CarbonTrack also supports an organisational perspective.

Organisations can analyse aggregated employee sustainability data through dedicated dashboards.

This enables:

  • Team-level footprint analysis
  • Category-wise emissions
  • Monthly trends
  • Employee comparisons
  • Sustainability reporting
  • Organisational progress tracking

This makes CarbonTrack suitable not only for individuals, but also as a foundation for corporate sustainability initiatives.


🖥️ Dashboard

The CarbonTrack dashboard brings the entire sustainability journey together in one place.

It combines:

  • 📌 Key footprint statistics
  • 🥧 Category-wise visualisations
  • 📈 Weekly trends
  • 🎯 Goal progress
  • 🔥 Streak information
  • 🏆 Achievements
  • 💡 Personalised recommendations
  • 🌍 Community insights

Screenshots

📸 Dashboard screenshots will be added here.

screenshots/
├── landing-page.png
├── dashboard.png
├── activity-logging.png
├── goals.png
├── leaderboard.png
└── organisation-dashboard.png

🏗️ System Architecture

CarbonTrack follows a modern full-stack architecture:

                    ┌──────────────────────┐
                    │      React.js        │
                    │      Frontend        │
                    └──────────┬───────────┘
                               │
                         REST APIs
                               │
                               ▼
                    ┌──────────────────────┐
                    │     Spring Boot      │
                    │       Backend        │
                    └──────────┬───────────┘
                               │
              ┌────────────────┼────────────────┐
              │                │                │
              ▼                ▼                ▼
       Authentication     Business Logic    Analytics
              │                │                │
              └────────────────┼────────────────┘
                               │
                               ▼
                    ┌──────────────────────┐
                    │        MySQL         │
                    │      Database        │
                    └──────────────────────┘

The overall flow is:

User Activity
      ↓
React Interface
      ↓
Spring Boot REST API
      ↓
Authentication & Validation
      ↓
Emission Calculation Engine
      ↓
MySQL Persistence
      ↓
Analytics & Aggregation
      ↓
Goals / Recommendations / Achievements
      ↓
Interactive Sustainability Dashboard

🛠️ Technology Stack

Frontend

  • React.js
  • JavaScript
  • HTML5
  • CSS3
  • Recharts
  • Axios

Backend

  • Java
  • Spring Boot
  • Spring Data JPA
  • Hibernate
  • Spring Security
  • JWT
  • REST APIs
  • Bean Validation
  • Spring Application Events

Database

  • MySQL
  • JPA / Hibernate
  • Flyway

Analytics & Performance

  • JPQL aggregate queries
  • Redis caching
  • Data-driven recommendation engine

API & Testing

  • RESTful APIs
  • Swagger / OpenAPI
  • JUnit
  • Mockito
  • Integration testing

🧩 Engineering Concepts Behind CarbonTrack

CarbonTrack isn't only a sustainability application — it is also a demonstration of practical software engineering patterns.

⚙️ Configurable Rule Engine

Emission factors are stored as data rather than being tightly coupled to business logic.

🗄️ Database-Driven Architecture

Core application entities and emission factors are persisted and managed through a structured relational database.

📊 Aggregation & Analytics

Raw activity logs are transformed into meaningful daily, weekly, and monthly insights.

⚡ Caching

Frequently requested analytics can be cached to improve dashboard responsiveness.

👀 Event-Driven Achievements

Application events allow achievement logic to remain decoupled from the core activity-logging workflow.

🔐 Secure APIs

Authentication and authorisation protect user data and application resources.

📱 Responsive UX

The interface is designed to make sustainability tracking approachable across different screen sizes.


🔄 End-to-End Flow

A typical CarbonTrack interaction looks like this:

                    USER
                     │
                     ▼
             Logs an activity
                     │
                     ▼
              React Frontend
                     │
                     ▼
              REST API Request
                     │
                     ▼
          Authentication & Validation
                     │
                     ▼
          Emission Calculation Engine
                     │
                     ▼
                MySQL
                     │
          ┌──────────┼──────────┐
          ▼          ▼          ▼
      Analytics    Goals     Achievements
          │          │          │
          └──────────┼──────────┘
                     ▼
            Recommendations
                     │
                     ▼
           Sustainability Dashboard

🌱 Our Vision

CarbonTrack is currently under active development.

The long-term vision is to move beyond manual carbon tracking and towards a more intelligent, automated sustainability ecosystem.

Imagine connecting everyday services and letting CarbonTrack understand your environmental footprint automatically.

Future integrations may include:

🚕 Uber / mobility platforms

🍔 Zomato / food delivery platforms

🛒 Shopping & purchase platforms

Energy consumption data

📱 Other everyday digital services

Instead of manually entering every activity, CarbonTrack could automatically detect relevant activities, calculate their environmental impact, and add them to the user's sustainability timeline.


🤖 The Future of CarbonTrack

Our future roadmap focuses on making the platform increasingly automated, intelligent and personalised.

🔗 Automated Activity Tracking

Connect external services such as mobility, food delivery and shopping platforms to automatically import relevant activities.

🧠 AI-Driven Sustainability Goals

Instead of forcing users to manually decide what goals to set, CarbonTrack could analyse their behaviour and suggest realistic, personalised goals.

🤖 Intelligent Recommendations

Future versions can evolve from rule-based recommendations towards increasingly contextual AI-driven sustainability guidance.

⚡ Zero-Touch Tracking

The ultimate goal:

User lives their normal life
          ↓
Connected services provide activity data
          ↓
CarbonTrack understands the activity
          ↓
Carbon footprint is calculated automatically
          ↓
Insights & recommendations are generated
          ↓
User sees their sustainability journey

From manual tracking → to intelligent sustainability.


👩‍💻 Contributors

Built with dedication by:

Contributor
Ditya
Tanuja
Diyali

Team CarbonTrack 🌱


🚧 Project Status

🟢 Active Development

CarbonTrack is a working full-stack sustainability platform, with the features defined in the project requirements implemented and additional UX and engagement features developed beyond the original scope.

The platform will continue evolving with smarter automation, integrations and AI-powered sustainability experiences.


🌍 Our Belief

“You don't need to change the whole world in one day.

You just need to make one better choice today.”

CarbonTrack exists to make those choices visible.

Because when people can measure their impact, they can understand it.

When they can understand it, they can change it.

And when millions of small changes become one collective movement —

🌎 We move towards a more sustainable future.


🌱 CarbonTrack

Measure your impact. Build better habits. Leave a lighter footprint.

About

Full-stack sustainability platform that tracks user activities, calculates carbon emissions, and provides personalised insights, goals, analytics, and recommendations. Built with React.js, Spring Boot, MySQL, JWT, Redis, and REST APIs.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages