A cross platform app built in Flutter that displays memorable quotes.
Checkout the website or download the mobile installables from here.
-
Quotes: Add/Edit quotes as per your. Browse through the entire collection of memorable quotes presented in an elegant and user-friendly interface.
-
Search Quotes: Looking for a specific quote? Use the search feature to quickly find quotes based on keywords or phrases.
-
Author Pie Chart: Gain insights into the distribution of quotes across various authors through an interactive pie chart.
-
Leaderboard: Discover the most prolific authors by exploring the leaderboard, which ranks them based on the number of quotes attributed to each.
-
Random Quote: Get a dose of entertainment with a random quote feature, perfect for those moments when you want an entertaining surprise.
-
Dark Mode: Switch to the dark side if you see fit.
The app utilizes the following key technologies
-
Clean Architecture: The Quotify app is built on Clean Architecture principles, separating the application into distinct layers: presentation, domain, and data. This architectural approach promotes modularity, testability, and a clear separation of concerns.
-
State Management with BLoC: For efficient state management, the app employs the BLoC (Business Logic Component) pattern. BLoC facilitates a clear separation of business logic from the UI, making the codebase more maintainable and testable.
-
Dependency Injection: Dependency injection is achieved through the use of two libraries: GetIt and Injectable. GetIt is a simple yet powerful service locator for Dart and Flutter, while Injectable provides a convenient and code-generation-based approach to dependency injection. This combination ensures a clean and organized dependency management system.
-
Networking with Dio: The app relies on Dio for efficient and flexible networking. Dio is a powerful HTTP client for Dart and Flutter, offering features like interceptors, FormData handling, and request/response transformation. It allows seamless integration with backend services to fetch and display quotes.
Follow these steps to get the Quotify app up and running on your local machine:
-
Clone the Repository:
git clone https://github.com/cyrilpillai/quotes-client.git
-
Navigate to the Project Directory:
cd quotes-client -
Install Dependencies:
flutter pub get
-
Run the App:
flutter run
Checkout Quotify Service - REST API server built using ExpressJS & DynamoDB that powers this app.
Contributions to Quotify App are welcome! If you would like to contribute, please follow these steps:
-
Fork the repository.
-
Create a new branch for your feature or bug fix:
git checkout -b feature/your-feature-name
-
Make your changes and commit them:
git commit -m "Add your commit message" -
Push your changes to your forked repository:
git push origin feature/your-feature-name
-
Open a pull request on the main repository.
Please ensure that your code adheres to the existing code style and includes appropriate tests.
Copyright 2022 Cyril Pillai
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.