Weather App 🌤️

A simple weather application built with Flutter that fetches and displays current weather data based on the user's location or a searched city. The app uses the OpenWeather API for weather data and includes support for location-based services.

Table of Contents

• Features
• Screenshots
• Technologies Used
• Setup and Installation
• Usage
• API Integration
• Contributing

Features

• 🌎 Location-based Weather: Automatically detects the user's current location and displays the current weather.
• 🔍 City Search: Allows users to search for the weather in different cities.
• 📅 Current Date & Time: Displays the current date, day, and time.
• 🌦️ Weather Details: Shows temperature, weather description, humidity, and precipitation chances.
• 🌐 Weather Icons: Displays weather icons corresponding to the current conditions.
• 🛰️ Real-Time Updates: Fetches updated weather data for new locations.

Screenshots

Weather Screen	City Search Screen

Technologies Used

• Flutter: Cross-platform UI toolkit for building natively compiled applications.
• Dart: Programming language used for Flutter apps.
• Provider: State management solution for managing weather data.
• OpenWeather API: External API service to fetch real-time weather data.

Setup and Installation

Prerequisites

• Flutter SDK: Install Flutter
• Dart SDK: Comes bundled with Flutter.
• OpenWeather API Key: You will need an API key from OpenWeather.

Steps

1. Clone the repository:

   git clone https://github.com/sayvilahsiav/weather_app.git

2. Navigate to the project directory:

   cd weather_app

3. Install the dependencies:

   flutter pub get

4. Create a file called config.dart in the lib folder and add your OpenWeather API key:

   // config.dart
   const String openWeatherAPIKey = 'YOUR_API_KEY';

5. Run the app:

   flutter run

Usage

1. On launching, the app will automatically detect your location and show the current weather conditions.
2. Use the location refresh button in the top-left corner to update your location-based weather information.
3. Tap the search button in the top-right corner to search for the weather in a specific city.
4. Weather details such as temperature, humidity, and precipitation will be displayed along with relevant weather icons.

API Integration

This app uses the OpenWeather API to fetch weather data.

To set up the API:

1. Sign up for an account on OpenWeather and get an API key.
2. Add the key in config.dart as described above.

API endpoints used:

• By Location: Fetches weather data based on the user's latitude and longitude.
• By City: Fetches weather data by city name.

Contributing

Contributions are welcome! If you'd like to contribute, please follow these steps:

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