SA Weather App

Table of Contents

• Overview
• Features
• Technologies Used
• Installation
• Usage
• API Sources
• Future Improvements
• Contributing
• License

Overview

The SA Weather App is a dynamic web application that provides real-time weather information for cities across South Africa. Users can search for a city, view current weather conditions, and explore additional weather layers such as precipitation and temperature. The app is designed to be user-friendly and informative, catering to both casual users and weather enthusiasts.

Features

• Real-time Weather Data: Get instant updates for any city in South Africa.
• Interactive Map: Explore different locations with a user-friendly map interface.
• Layer Options: Visualise various weather conditions by adding layers like precipitation and temperature.
• Cached Data: Fast loading times with local storage support for previously searched cities.

Technologies Used

• HTML: Structure of the web application.
• CSS: Styling and layout.
• JavaScript: Interactive functionality and API calls.
• Leaflet.js: For mapping and geospatial visualisations.
• APIs:
  • OpenWeather
  • City API
  • Weather API

Installation

To run the SA Weather App locally, follow these steps:

1. Clone the repository:
   • git clone https://github.com/yourusername/sa-weather-app.git
2. Navigate to the project directory:
   • cd sa-weather-app
3. Open the index.html file in your web browser.

Usage

1. Enter a city name in the search bar.
2. Click the search button or press Enter.
3. The map will update to display the current weather conditions for the selected city.
4. Use the layer options to visualise additional weather data such as precipitation.
5. Click the theme button to change the theme.

API Sources

Data provided by:

• OpenWeather
• City API
• Leaflet
• Weather API

Future Improvements

• Enhance mobile responsiveness for a better user experience.
• Implement user authentication for personalised weather data.

Contributing

Contributions are welcome! If you'd like to contribute, please fork the repository and create a pull request. Make sure to follow these steps:

1. Fork the repository.
2. Create a new branch (git checkout -b feature/YourFeature).
3. Make your changes and commit them (git commit -m 'Add your feature').
4. Push to the branch (git push origin feature/YourFeature).
5. Open a pull request.