Carbon Tools

This is a mono-repository/multi-package built with Lerna & TypeScript.

Contents

1. bytes-to-co2: A library that estimates the CO2 released to the atmosphere based on the transferred byte size.
2. co2-extension: A Chrome (for now) that shows the amount of CO2 released by visiting the current page.
3. lighthouse-plugin-co2: A Lighthouse Plugin that calculates the CO2 of all the data transferred by a page.
4. co2-data: A small library with information of carbon intensities by country.

Using as a dependency

For now, we are only exposing as libraries co2-data and bytes-to-co2, which you can install in your project using:

• yarn add bytes-to-co2 or npm i bytes-to-co2
• yarn add co2-data or npm i co2-data

Development - Getting started

Project supports NodeJS >= v20.x

1. Clone the project git clone https://github.com/dvelasquez/carbon-tools.git
2. Run pnpm i to install the dev dependencies
3. Use pnpm lerna:build to build all the libraries
4. Use pnpm lint to lint files and catch issues with the code styling, or possible code errors
5. Use pnpm test to run Node TAP tests