Skip to content

Stay ahead of the forecast with real-time weather updates and personalised alerts with this intuitive weather app.

Notifications You must be signed in to change notification settings

gazjosef/weather-map

Repository files navigation

Contributors Forks Stargazers Issues MIT License LinkedIn


Weather App Logo

Weather App

Stay ahead of the forecast with real-time weather updates and personalized alerts with this intuitive weather app.

View Demo · Report Bug · Request Feature

Table of Contents
  1. About The Project
  2. Getting Started
  3. Usage
  4. Roadmap
  5. License
  6. Contact

About The Project

Product Name Screen Shot

This interactive Weather Map is built with Vite, React, and TypeScript, providing real-time weather data for a selected location. The map is powered by the OpenWeather API and visualised using React Leaflet, offering an intuitive way to explore weather conditions.

Key Features

  • Live Weather Data with React Query – Efficiently fetches and caches weather data to ensure a smooth user experience.
  • Context API for State Management – Stores and manages weather details, making data accessible across the app.
  • Interactive Map Interface – Users can explore weather conditions by interacting with a dynamic map, including zoom and location selection.
  • Styled with Styled-Components – Provides a responsive and visually appealing UI.

This project demonstrates the power of React Query, Leaflet maps, and API integrations, creating a seamless experience for accessing real-time weather information. 🌍☀️🌧

(back to top)

Built With

  • Vite
  • TypeScript
  • React
  • React Query
  • Context-API
  • Styled Components
  • Cypress

(back to top)

Getting Started

Prerequisites

  • npm
    npm install npm@latest -g

Installation

  1. Get a free API Key at https://openweathermap.org/
  2. Clone the repo
    git clone https://github.com/gazjosef/weather-app.git
  3. Install NPM packages
    npm install
  4. Enter your API in .env
    const API_KEY = "ENTER YOUR API";

(back to top)

Usage

Use this space to show useful examples of how a project can be used. Additional screenshots, code examples and demos work well in this space. You may also link to more resources.

For more examples, please refer to the Documentation

(back to top)

Roadmap

  • Display temperature, location, and date.
  • Display wind speed, feels like, humidity, and pressure.
  • Display upcoming temperature.
  • Add search fields.
  • Refactor to TypeScript.
  • Unit & E2E testing.

See the open issues for a full list of proposed features (and known issues).

(back to top)

License

Distributed under the MIT License. See LICENSE.txt for more information.

(back to top)

Contact

Email: [email protected]

(back to top)

About

Stay ahead of the forecast with real-time weather updates and personalised alerts with this intuitive weather app.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published