Cocktalez is a well-structured Flutter application that allows you to explore a wide range of cocktail recipes. This project serves as a portfolio showcase, demonstrating the implementation of key Flutter concepts and libraries, such as Riverpod for state management, clean architecture, cool animations, theming and tests.
- Browse an extensive collection of cocktail recipes.
- View details of each cocktail, including ingredients, instructions, and an image.
- Search for cocktails by name or ingredient.
- View cocktails by Glass
- View Cocktails By Ingredients
- Enjoy smooth and visually appealing animations throughout the app.
- Ensure that you have Flutter and Dart installed on your machine. For installation instructions, refer to the official Flutter documentation
- Clone the Cocktalez repository using the following command:
git clone https://github.com/Wolfof420Street/cocktalez.git - Navigate to the cloned repository on your machine and install all dependencies by running:
flutter pub get - To run the app, use the command:
flutter run - Please ensure you have a connected device or an emulator running.
Cocktalez is based on clean architecture principles. The project is divided into the following layers:
- Presentation Layer : Contains UI related elements such as Widgets and animation files.
- Domain Layer : Called the provider in the code for each module. Contains business logic, entities and use cases.
- Service Layer : Called the service class. This class handles the data from The Cockail DB API
The application has a comprehensive set of tests that cover both unit and widget tests, ensuring code quality and functionality at all times.
To run the tests, use the following command in the terminal:
flutter test
Cocktalez provides a robust example of a Flutter application using clean architecture, state management with Riverpod, and high-quality animations. It demonstrates best practices for structuring and managing Flutter projects. Enjoy exploring Cocktalez!
For any questions or comments, feel free to reach out.
UI inspo from Flutter Vignettes
This project is released under the MIT license. You can use the code for any purpose, including commercial projects.
