Skip to content

x-brymo/weather_plus

Repository files navigation

Weather Plus ☁️🌦️

A beautiful & simple Flutter app for real-time weather forecasting.


✨ About

Weather Plus is a fully-featured weather application built using Flutter. It provides users with real-time weather updates, extended forecasts, and interactive weather information. Designed with a clean and dynamic UI, it offers an engaging experience to check weather conditions anywhere.


💡 Features

  • 🌡️ Display current weather with temperature, humidity, wind speed, and weather status.
  • 🗓️ 7-day detailed weather forecast.
  • 🔍 Search weather for any city worldwide.
  • 🎨 Dynamic and animated background that changes according to the weather condition.
  • ⏰ Real-time data with accurate weather API integration.
  • 📱 Responsive design for all screen sizes.

🛠 Packages Used

Package Usage
flutter_riverpod State management
flutter_spinkit Loading animations
intl Date and time formatting
flutter_riverpod State management
flutter_animate Animations
google_fonts Custom fonts
shared_preferences Local storage
json_annotation JSON serialization
freezed_annotation Immutable state management
geolocator Retrieve device location
geocoding Convert coordinates to addresses
lottie Animated illustrations
dio HTTP requests
firebase_messaging Push notifications
equatable Value comparisons
shorebird Value Update System

Dev Dependencies:

Package Usage
flutter_test Testing Flutter apps
build_runner Code generation
freezed Data classes and union types
json_serializable JSON serialization

🚀 Getting Started

Follow these steps to run the project locally:

  1. Clone the repository

    git clone https://github.com/x-brymo/weather_plus.git
  2. Navigate to the project directory

    cd weather_plus
  3. Install dependencies

    flutter pub get
  4. Run the app

    flutter run

📸 Screenshots

(Optional: Add screenshots of the app UI here)


✅ Requirements

  • Flutter SDK (latest stable)
  • Weather API key (you need to register on a weather API service)

🔍 How to Get a Weather API Key

To use this app, you need an API key from a weather data provider. Follow these steps:

  1. Register at OpenWeather or WeatherAPI.
  2. Sign up and generate an API key.
  3. Add your API key to the project in the configuration file.

👨‍💻 Author

Mahmoud Hafez Eltarqi

For suggestions, contributions, or bug reports, feel free to open an issue or a pull request.


⭐ Contribution

Contributions are welcome! Feel free to fork the repo, submit a PR, or open an issue. Let's build something amazing together!

Follow me on GitHub for more projects and updates.


🌐 License

This project is licensed under the MIT License.

MIT License

Copyright (c) 2025 Mahmoud Hafez Eltarqi

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published