Weather Application README

Welcome to the Weather Application! This web application allows users to search for weather information for any country or city around the world. It provides current weather conditions, temperature, humidity, wind speed, and weather description. Additionally, it offers a three-day weather forecast, a seven-day weather history, weather insights, clothing suggestions, activity recommendations, and air pollution data.

Preview

https://shanb98.github.io/WeatherApp2.0/

Table of Contents

• Features
• Technologies Used
• How to Use
• APIs Used
• Performance
• Responsive Design
• Contribution Guidelines

Features

1. Weather Information

• Users can search for the current weather of any country or city.
• The application displays the current temperature, humidity, wind speed, and weather description.

2. Weather Forecast

• Users can view a three-day weather forecast starting from the current day.

3. Weather History

• Users can access a seven-day weather history to review past weather conditions.

4. Weather Insights

• Provides additional weather insights such as sunrise, sunset, moonrise, moonset, average temperatures, and a brief comparison of today's rainfall vs. yesterday's.

5. Clothing Suggestions and Activity Recommendations

• Offers clothing recommendations based on the current weather conditions.
• Recommends suitable activities for the day based on the weather.

6. Air Pollution Data

• Displays air pollution data for the selected location.

Technologies Used

The Weather Application is built using the following technologies:

• HTML
• CSS
• Bootstrap
• JavaScript
• jQuery
• Google Maps API (for location display)
• OpenWeatherAPI (for weather data)

How to Use

1. Clone this repository to your local machine.
2. Open the index.html file in your preferred web browser.
3. In the search bar, enter the name of the country or city for which you want to check the weather.
4. Click the "Search" button, and the application will display the weather information for the specified location.

APIs Used

• Google Maps API: Used to display the location on a map.
• OpenWeatherAPI: Used to retrieve weather data, including current conditions, forecasts, and historical weather.
• TheWeatherAPI: Used to retrieve weather data, including current conditions, forecasts, and historical weather.

Performance

The website is optimized for performance to ensure fast loading times and a smooth user experience. Efforts have been made to minimize unnecessary network requests and optimize resource loading.

Responsive Design

The application is fully responsive, ensuring that it adapts seamlessly to different screen sizes and devices. The user interface has been designed to be user-friendly and intuitive, providing a consistent experience across various devices.

Thank you for using the Weather Application! If you have any questions or feedback, please don't hesitate to contact us.

UI

Contribution Guide

We welcome contributions from the open-source community to help improve the Weather Application. Whether you want to report a bug, suggest an enhancement, or contribute code, we appreciate your help in making this project better.

Reporting Issues

If you encounter any bugs, issues, or have feature requests, please open an issue on our GitHub repository.

When reporting issues, please provide as much detail as possible, including:

• A clear and concise description of the problem.
• Steps to reproduce the issue.
• Screenshots, if applicable.
• Any error messages you encountered.

Making Contributions

If you'd like to contribute to the project by fixing bugs or adding new features, please follow these steps:

1. Fork the repository to your GitHub account.

2. Clone the forked repository to your local machine:

   git clone https://github.com/your-username/your-forked-repo.git

3. Create a new branch for your contribution:

   git checkout -b feature-or-fix-name

4. Make your changes and commit them with a clear and concise commit message:

   git commit -m "Add feature or fix"

5. Push your changes to your GitHub fork:

   git push origin feature-or-fix-name

6. Create a pull request (PR) from your fork to the original repository:

   • Visit the GitHub repository.
   • Click on the "New Pull Request" button.
   • Select the base branch (usually main or master) and your feature branch.
   • Provide a clear description of your changes in the PR.

7. Wait for feedback and approval from the maintainer.