My Bookshelf App

My Bookshelf is an Android application developed in Kotlin using Jetpack Compose. It helps users organize, search, and manage a personal library of books.

The app integrates with the Google Books API to fetch book information and uses Room Database for local storage of user selections.

• Home Screen — View saved books from the local database
• Search Screen — Query books using Google Books API
• Book Details — View cover, title, author, description, and rating in a styled popup
• Add Book — Save books from search results to the local collection
• Update Status — Change status between Should Read, Reading, and Read
• Delete Book — Remove a book with confirmation
• Filter — Filter books by status using selection chips

• Kotlin
• Jetpack Compose
• Navigation Component
• Room Database
• Retrofit
• Coil (Image loading)
• Google Books API
• MVVM Architecture

Each book can have one of the following statuses:

• Should Read — default when added
• Reading
• Read

These are visually styled using color-coded chips for intuitive filtering.

1. Clone or download the project repository
2. Open the project in Android Studio
3. Allow Gradle to sync all dependencies
4. Run the app on a connected emulator or physical Android device
5. Ensure the device has Internet access for API requests

• You must increment the Room database version when updating the `Book` entity or schema, otherwise you will get a `Room cannot verify the data integrity` crash.
• Some books from the Google Books API may not return thumbnails or descriptions — fallback text is displayed in such cases.
• Covers sometimes fail to load due to null `imageLinks.thumbnail`.