Skip to content

Latest commit

 

History

History
186 lines (121 loc) · 7.63 KB

README-en.md

File metadata and controls

186 lines (121 loc) · 7.63 KB

GitHub language count Repository size GitHub last commit

Banner

English 🇺🇸
Portguese 🇧🇷

🚧 estimator - [ MVP ] 🚧

AboutFeaturesLayoutRunningTechnologiesAuthorReferences

💻 About

The aim behind this project is to provide users with a simple and easy-to-use tool to estimate the carbon footprint on their daily activities. Whether it's commuting to work, shopping, or even hanging out at the hotel, this app will calculate the estimated carbon emissions associated with those activities.

The app is currently under development and new features will be added in the future to further enhance the user experience and add more activities to the list.

By providing this information to users, they can make more informed decisions about their daily habits and potentially reduce their carbon footprint. Feel free to clone this project, modify and give feedbacks.


⚙️ Features

Users have access to the web app (mobile and desktop responsiveness) where they can:

  • estimate the carbon footprint of a given category for their country (location obtained via IP)
  • change country in a country selector
  • filter CO2 emissions by year and region
  • switch between ligth/dark theme

▶️ Preview

This project has a demo version deployed at Vercel. Click here and check it out.

🎨 Layout

The application layout is available in Figma:

Made by Filipe Correia

Mobile

Estimator Welcoming Page on a mobile device Estimator Categories Page on a mobile device Estimator Stats Page on a mobile device

Desktop

Estimator Welcoming Page on a larger screen


🚀 Running the project

This project requires third-party dependencies to run, see below for steps to running locally.

Prerequisits

Before you start, you will need to have the following tools installed on your machine: Git, Node.js, and also a package manager like [npm](https://www. npmjs.com/package/npm) or yarn. In addition it is good to have an editor to work with the code, such as VSCode

🔑 Get the Climatiq API key

In order to work properly, this project is powered by the Climatiq database. Climatiq offers a REST API that brings data and information related to climate and environmental factors such as temperature, humidity, carbon emissions on a local and global scale.

To get a free API-key follow the official instructions here

🧭 Runnnig the web app

# Clone this repo
$ git clone git@github.com:f7lipe/frontend-test-two

# Access the project folder in your terminal/cmd
$ cd f7lipe/frontend-test-two

# Install dependecies
$ npm install // yarn install

# Create a environment file
$ touch .env.local 

# In the .env.local file created add a variable API_BASE_URL and API_KEY as shown in the .env.example file located in the root folder of this directory
$ nano .env 

API_BASE_URL = "https://beta3.api.climatiq.io"
API_KEY = "PASTE HERE YOUR API KEY FROM CLIMATIQ.IO"

# Save

# Run the application in development mode
$ npm run dev // yarn run dev

# The application will open on port:3000 - go to http://localhost:3000

🛠 Technologies

The following tools were used in building the project:

Website (Next.JS) + (JavaScript)

See package.json

Tools


🦸 Author


Filipe Correia

Linkedin Badge Gmail Badge Twitter Badge


📚 References

📝 Project

This project is part of a technical challenge made for Orma Carbon.

Made with ❤️ by Filipe Correia 👋🏽 Contact us!