Skip to content

README.md

Latest commit

 

History

History
200 lines (135 loc) · 6.17 KB

README.md

File metadata and controls

200 lines (135 loc) · 6.17 KB
Raw
QuoteHub Logo

QuoteHub

Daily Inspiration Through Curated Quotes

Play Store Flutter Status Rating

A beautifully designed Flutter app that delivers daily inspiration through curated quotes and random words.

📱 Download on Play Store • 🔗 Main Repository

✨ Features

  • 🔐 Full User Authentication - Complete login, signup, and profile management
  • 📅 Daily Quote Widget - Start each day with inspiring "Quote of the Day"
  • ❤️ Favorite & Share - Browse, save, and share your favorite quotes
  • 🎲 Random Word Explorer - Discover new words with beautiful illustrations
  • 🔍 Full-Text Search - Find any quote instantly across the entire collection
  • 🏗️ Clean Architecture - Built with BLoC state management pattern
  • 📴 Offline-First - Access your content anytime, anywhere without internet
  • 📥 Download & Save - Export quotes and illustrations as images

🛠️ Technologies

Technology Purpose
Flutter Cross-platform mobile framework
Dart Programming language
BLoC State management pattern
Clean Architecture Code organization & scalability
REST API Backend communication
SharedPreferences Local data persistence

📱 Screenshots

Screenshot 1 Screenshot 2 Screenshot 3
Screenshot 4 Screenshot 5 Screenshot 6
Screenshot 7 Screenshot 8 Screenshot 9

🏆 Project Results

✅ Successfully published on the Google Play Store, showcasing advanced Flutter architecture

✅ Created a fully open-source project with detailed documentation to help the developer community

✅ Achieved highly performant and smooth user experience due to clean architecture and BLoC

✅ Ensured reliable offline mode, allowing users to access content anytime, anywhere

🎯 Challenges & Solutions

Challenges Faced

  1. Clean Architecture Implementation

    • Implementing a strict Clean Architecture to ensure the app is scalable and maintainable

  2. Complex State Management

    • Managing complex state interactions for authentication, data fetching, and offline support using BLoC

  3. Offline-First Experience

    • Creating a seamless offline-first experience using a local/remote repository pattern

Solutions Implemented

✨ Organized code into distinct layers - Separated data, domain, and UI layers for clear separation of concerns

✨ Utilized flutter_bloc - Implemented predictable state management across all app features

✨ Leveraged SharedPreferences - Used robust repository pattern to cache data for offline use

📊 Project Information

Detail Information
Status ✅ Completed
Duration 4 months
Team Size 1 developer
Client Ionic Errrors Code
Category Mobile Application
Type Business

🚀 Getting Started

Prerequisites

  • Flutter SDK (latest stable version)
  • Dart SDK
  • Android Studio / VS Code
  • Android/iOS device or emulator

Installation

  1. Clone the repository
git clone https://github.com/malikhaider1/top_quotes.git
cd top_quotes
  1. Install dependencies
flutter pub get
  1. Run the app
flutter run

📁 Project Architecture

This project follows Clean Architecture principles with three main layers:

lib/
├── data/           # Data sources, repositories implementation
├── domain/         # Business logic, use cases, entities
└── presentation/   # UI, BLoC, widgets

State Management: BLoC (Business Logic Component) pattern for predictable and testable state management.

🤝 Contributing

Contributions, issues, and feature requests are welcome! Feel free to check the issues page.

📄 License

This project is open source and available under the MIT License.

👨‍💻 Developer

Ionic Errrors Code

💬 Support

If you like this project, please consider:

  • ⭐ Giving it a star on GitHub
  • 📥 Downloading it from the Play Store
  • 🐛 Reporting bugs or suggesting features

Made with ❤️ by Ionic Errrors Code

© 2026 QuoteHub. All rights reserved.