Skip to content

Android app for book lovers to organize and track their personal library. Built with Java and Material Design 3.

License

Notifications You must be signed in to change notification settings

mmiheev/BookLub

Repository files navigation

BookLub - Personal Library Manager

Android application for book lovers to organize and track their personal library. Built with Java and Material Design 3.

Features

  • 📖 Book Management - Add, edit, and organize your books with detailed information
  • ⭐ Favorites & Reading Progress - Mark books as favorites and track reading status
  • 🗂️ Smart Categorization - Organize by authors, genres, series, and publication years
  • 💬 Quotes Collection - Save and manage your favorite book quotes
  • 📊 Reading Statistics - Track your reading habits with detailed insights
  • 🎯 Modern Material Design - Clean, intuitive interface following Material Design 3

Quick Start

Installation

  1. Clone the repository:
git clone https://github.com/mmiheev/BookLub.git
cd booklub
  1. Open the project in Android Studio:
android-studio .
  1. Build and run the application:
  • Connect an Android device or start an emulator
  • Click "Run" in Android Studio or use ./gradlew installDebug

Requirements

  • API 24 or higher
  • Java 8 or higher

Usage

Adding Books

  1. Navigate to the "Books" section
  2. Tap the floating action button to add a new book
  3. Fill in book details: title, author, genre, series, description, and personal notes
  4. Mark as favorite or finished as needed

Managing Quotes

  1. Go to the "Quotes" section
  2. Add your favorite quotes from books with author attribution
  3. Easily browse and search through your quote collection

Tracking Progress

  • View reading statistics in the "Goals" section
  • Track books finished per year
  • Monitor your reading habits and set personal goals

Contributing

I welcome contributions! Please follow these steps:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature-name)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature-name)
  5. Open a Pull Request

Support

If you encounter any issues or have questions:

  • Create an Issue in the repository
  • Check existing Issues before creating a new one
  • Provide detailed description of the problem including:
    • Device model and Android version
    • Steps to reproduce the issue
    • Screenshots if applicable

Technical Details

  • Language: Java
  • Minimum SDK: API 24
  • Architecture: Traditional Android (Activities + Fragments)
  • Database: SQLite with optimized queries
  • UI: Material Design Components

About

Android app for book lovers to organize and track their personal library. Built with Java and Material Design 3.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages