clim8

A clean, minimalistic weather app that delivers real-time data using the OpenWeather API.

---

Features

• Real-time weather information, including temperature, humidity, wind speed, atmospheric pressure, and "feels like" temperature.
• 5-day weather forecast with 3-hour intervals.
• Automatic dark and light theme based on the user's system preferences.
• Fully responsive design for desktop, tablet, and mobile devices.
• Search by city and country code, with optional browser geolocation support.
• Unit switching between Metric (°C, m/s) and Imperial (°F, mph).
• Detailed wind information, including sunrise and sunset times.
• Express.js backend with an OpenWeather API proxy.

---

Requirements

• Node.js
• npm
• An OpenWeather API key.

Tip

Using the latest LTS version of Node.js is recommended for the best compatibility and performance.

---

Quick Start

Clone the repository:

git clone https://github.com/goncalopolido/clim8

Navigate to the project directory and install the dependencies:

cd clim8
npm install

Create the environment file:

cp .env.example .env

Edit the .env file and add your OpenWeather API key.

Start the server:

npm start

Once the server is running, clim8 will be available at:

http://localhost:3000

---

Live Demo

The latest public version of clim8 is available at clim8.polido.pt.

---

Notice

Note

clim8 currently uses OpenWeather API v2.5 for weather data and v1.0 for geocoding. Future OpenWeather API updates may introduce breaking changes that require updates to the application's endpoints or data handling logic.

---

Acknowledgments

• Weather data: OpenWeather
• Weather icons: basmilius/weather-icons