Weathque

Description

Weathque is a dynamic weather application created using Flutter and Dart, offering a seamless way to stay informed about the weather conditions. Embrace every day fully prepared with accurate real-time weather updates and a comprehensive 5-day forecast.
Designed with the user in mind, Weathque integrates a Clean architecture pattern, combining Repository and Bloc patterns, to ensure efficient data management and an intuitive experience.

Table of Contents

• Design
• Architecture
• Features
• Supported platforms
• Installation
• Usage
• Screenshots and Demo
• Changelog
• Used Packages
• License

Design

All design credits belong to Desire Creative Agency.
The original design was taken from Dribbble.

Architecture

Weathque fully embraces the Clean Architecture pattern, incorporating both the Bloc and Repository patterns.
Clean Architecture consists of the following layers:

1. Data Layer
2. Domain Layer (Business Logic)
3. Presentation Layer (UI)
   
   

Architecture for API calls:

Architecture for Storage calls:

Features

• Get the latest weather data using the OpenWeatherMap API for up-to-the-moment accuracy.
• Access a 5-day weather forecast to plan ahead.
• Get weather updates for a variety of cities, allowing you to stay informed about conditions worldwide.
• Elegant design featuring captivating animations and a vibrant color palette.
• Experience a responsive design that seamlessly adapts to different devices.
• Easily add your own cities and track the weather in each of them.

Supported platforms

Weathque is a cross-platform mobile application that supports both Android and iOS platforms.

Installation

To run the Weathque app locally, follow these steps:

1. Clone this repository to your local machine.
2. Ensure you have Flutter and Dart installed on your system.
3. Navigate to the project directory in your terminal.
4. Run the command flutter pub get to install the required dependencies.
5. Connect a device or start an emulator.
6. Run the command flutter run to launch the app.

Usage

1. Launch the Weathque app on your device or emulator.
2. Swipe right to navigate to the weather forecast of the next city.
3. Swipe left to move back to the weather forecast of the previous city.
4. For a 5-day weather forecast, simply swipe the "Weekly Forecast" cards.
5. To add your own city, follow these steps:
   • Tap the "Settings" icon on the app bar.
   • Enter your city name.
   • A new card will appear on the screen.
   • Close the Settings menu.
   • Swipe to your newly added city.
6. To remove unnecessary city tap "Settings" icon on the app bar
   • Tap the "Settings" icon on the app bar.
   • Swipe right or left on the city you want to remove.
   • The city will be removed.

Screenshots and Demo

Screenshots

Demo

Demo.mp4

Changelog

[1.1] - 25.08.2023

Added

• Now you can easily add your own cities and track the weather in each of them. 🔮

[1.0] - 16.08.2023

Added

• Initial release.

Used Packages

The Weathque app utilizes the following packages:

Name	Version	Link on pub.dev
flutter_bloc	8.1.3	Link
retrofit	4.0.1	Link
get_it	7.6.0	Link
intl	0.18.1	Link
flutter_carousel_slider	1.1.0	Link
fluttertoast	8.2.2	Link
shared_preferences	2.2.0	Link

License

Apache License Version 2.0