wether is a fluid location based weather app that gives all relevant weather data of the users current location in beautiful and easy-to-understand graphics.
| Platform | Available |
|---|---|
| Apple App Store | n/a (yet) |
| Google Play Store | wether |
This app was built with Flutter, and will eventually be available on both Android and iOS. Currently, wether is only available in the Google Play store.
This documentation will be organized through the two screens, the current weather screen, and the forecast screen; and additionally their similar functionalities will be discussed first. Both screens function very similarly with loading, error handling, and displaying the loaded data.
Both of the screens are structured using a FutureProvider, provided (hehe) by Riverpod for Flutter. When the screen appears, their is a state watcher for the (current weather or forecast) provider. The state watcher has 3 states:
- Loading
- Error
- Data
The future provider runs an async function which performs the API call for the weather/forecast data, and returns a Future value wrapped in one of the 3 states; so while it is being listened to in the widget tree, the appropriate Widget will appear. For both screens, the error and loading state look the same, and will be showed below.
While running the async function that the future provider contains, the state is set to loading. This is when the loading icon appears in the center of the screen while waiting for the state to change to data or error.
However, if the data has already been loaded and the data screen is showing, when the user refreshes the page, the loading state is different. Instead of only being a centered loading icon, the loaded data screen will continue to show but the pull to refresh loading icon will continue to float above the screen.
When the async function fetching the data returns an error state, this triggers the error state to appear which has the relative error message, a recommendation for the user how to fix the error, and a refresh button to call the async function fetching the API data again.
Alternatively, if the data has already been previously loaded, the data page continues to be displayed through the loading state, then if the error state is triggered, a snack bar pop ups at the bottom of the screen displaying the error message. This way the user still continues to see the previous data even if internet or location connection has been lost.
<widget tree of current weather>
<widget tree of forecast>