DogoApp is the user interface built on top of the Dogo API and the dogos_repository
. It allows users to perform the following actions:
- View random dog images.
- Select a specific dog breed.
- View a list of sub-breeds for a selected breed.
- View a gallery of dog images based on breed or sub-breed.
- Retrieve random dog images.
- Random image by breed
- Images list by breed (Gallery)
- Random image by breed and sub breed
- Images list by breed and sub breed (Gallery)
- Get a list of dog breeds.
- Get a list of sub-breeds for a specific breed.
To use the DogoApp, follow these installation instructions:
-
Clone the repository to your local machine:
git clone https://github.com/your-username/dogo-app.git``
-
Navigate to the project directory:
cd dogo
-
Install the required dependencies:
flutter pub get
-
Launch the app:
flutter run
The app should now be up and running on your device or emulator.
To get started with the DogoApp, follow these steps:
-
Launch the app on your device or emulator.
-
You will be presented with the main screen, which displays a random dog image.
-
Explore the app's features using the navigation options provided.
-
Launch the app.
-
Tap on the "Dogo Breed" Tile.
-
Select a dog breed from the list.
-
Home page will refresh with the selected breed
-
Launch the app.
-
Tap on the "Dogo Sub Breed" Tile.
-
Select a dog breed from the list.
-
Select a dog subbreed from the next list.
-
The home page will refresh with selected breed, sub-breed
-
Launch the app.
-
Tap the "Breed" Tile.
-
Select a dog breed from the list.
-
Browse through the collection of dog images.
-
Launch the app.
-
Tap the "Sub Breed" Tile.
-
Select a dog breed from the list.
-
Select a dog subbreed for the selected breed from the list.
-
Browse through the collection of dog images.
to run the test simply run
flutter test
- flutter_bloc (statemanagment)
- json_serializable (serialise data)
- mocktail (mock dog api)
for this app i utelised a decouple aproach to seperarte the api logic as a pacage of its own, the docs are bellow