Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/vihangan/hacktoberfest-2023


https://github.com/vihangan/hacktoberfest-2023

hacktoberfest hacktoberfest2023 hactoberfest-accepted

Last synced: 18 days ago
JSON representation

Awesome Lists containing this project

README

        

# Hacktober Fest 2023 Weather App

Welcome to the Hacktober Fest 2023 Weather App project! This open-source project aims to create a weather application with a world map, allowing users to select a country from a dropdown menu and providing automatic IP detection to display the user's country and weather information. We invite you to contribute to this project as part of Hacktober Fest 2023, which begins on October!

## Project Overview

This project's main goal is to create a user-friendly weather app with the following features:

- **World Map**: An interactive world map will be displayed, allowing users to explore weather information for different countries visually.

- **Country Selection**: Users can select a country from a dropdown menu to get detailed weather information for the chosen location.

- **Automatic IP Detection**: The app will automatically detect the user's IP address and display weather information for their current location.

## Design
![Design](resources/design-1.png)
![Design with dropdown](resources/design-2.png)
## Getting Started

Follow these steps to get started with contributing to the project:

1. **Fork the Repository**: Click the "Fork" button at the top right corner of this repository to create your own copy of the project.

2. **Clone the Repository**: Clone your forked repository to your local machine using the following command:

```
git clone https://github.com/VihangaN/hacktoberfest-2023
```

3. **Install Dependencies**: Make sure you have the necessary dependencies installed. You might need Node.js and npm. Check the project's `package.json` for more information.

4. **Create a Branch**: Create a new branch for your contributions using a descriptive name. For example:

```
git checkout -b feature/add-weather-info
```

5. **Make Changes**: Implement the features or improvements you'd like to contribute to the project.

6. **Commit Changes**: Commit your changes with a meaningful commit message:

```
git commit -m "Add weather data for selected countries"
```

7. **Push Changes**: Push your changes to your forked repository:

```
git push origin feature/add-weather-info
```

8. **Create a Pull Request**: Go to the [original repository](https://github.com/VihangaN/hacktoberfest-2023) and click the "New Pull Request" button. Provide a descriptive title and description for your pull request, then submit it.

## Contribution Guidelines

Please follow these guidelines when contributing to the project:

- Review the issue in the checklist and assign yourself to a feature by adding your GitHub handle [checklist](https://github.com/VihangaN/hacktoberfest-2023/issues/1)
- Create a new branch for each set of changes you make and name it descriptively.

- Make sure your code follows best practices, is well-documented, and is free of errors.

- Test your changes thoroughly to ensure they work as expected.

- Be respectful and open to feedback from maintainers and other contributors.

- Remember that this project follows the Hacktober Fest code of conduct. Please be respectful and inclusive in your interactions.
- ⚠️ We added a weather API key for easy use of the project since this is open source (not a best practice). Please don't misuse it.

### Contributors


## Contact

If you have any questions or need further assistance, feel free to contact us:

We look forward to your contributions to the Hacktober Fest 2023 Weather App! Happy coding!