[SultanZhalifa]

Full architectural overhaul of the app. Replaces the Java/SQLite prototype with a clean MVVM stack and a Material 3 user interface, plus adds onboarding, dashboard, PDF export, JSON backup/restore, theme toggle, and Google Books ISBN auto-fill.

Architecture

• Single-Activity host (MainActivity) + Navigation Component graph for Dashboard, Library, Detail, Add/Edit, Settings. Auth + Onboarding live in their own activities.
• Repository pattern between ViewModels and Room. Reactive reads via Flow/StateFlow.
• Hand-rolled ServiceLocator for DI; ViewModelFactory wires constructors.

Data layer

• Room database with UserEntity + BookEntity (cover URI, status, rating, progress, notes, dateAdded, lastModified). DAOs use suspend + Flow.
• PreferencesManager: typed wrapper around SharedPreferences for session, theme, last-used sort/filter.
• Salted SHA-256 password hashing replaces plaintext storage.

UI

• Material 3 theme tokens (light + dark) with brand palette and typed text styles.
• Onboarding (3-slide ViewPager2 with dot indicators), Login/Register with inline validation, Dashboard with status breakdown + recent rail, Library with search / sort / filter (persisted) and swipe-to-delete + Snackbar UNDO, Detail with rating
  • reading progress + Share, Add/Edit form with cover picker and ISBN auto-fill, Settings with theme toggle + PDF export + JSON backup/restore + sign-out.
• 25+ Material vector icons and gradient drawables.

Features

• Cover image picker via the modern Photo Picker (no permission on Android 13+); bytes copied to internal storage so they survive app restarts.
• Reading status (Want / Reading / Finished) with progress tracking (current / total pages) for "Currently Reading" books.
• 5-star rating with sortable ranking on the dashboard average.
• Sort by title / date / rating; filter by reading status; preferences persisted.
• PDF export via platform PdfDocument API (no third-party PDF lib).
• JSON backup/restore via org.json, written through MediaStore on Q+, FileProvider on older devices.
• Google Books ISBN auto-fill: pre-populates title, author, year, category, and page count from a 10/13-digit ISBN. Network done with HttpURLConnection only — no new dependencies. User-typed input is preserved (never overwritten).
• Theme toggle: System / Light / Dark. AppCompatDelegate-driven.
• Splash screen with brand gradient (no white flash on cold launch).

Tooling

• Kotlin 2.0.21, AGP 8.11, Gradle 8.13, JDK 17. compileSdk=35, minSdk=21, targetSdk=34.
• ViewBinding, KSP, Navigation Safe Args, Coil 2.7.
• Coroutines + Flow. lifecycle-runtime-ktx for repeatOnLifecycle.

Testing

• 8 unit-test classes covering PasswordHasher, enum storage values, both repos, all ViewModels (auth/list/edit), and the Google Books parser. JUnit + MockK + Turbine
  • kotlinx-coroutines-test.

Project hygiene

• LICENSE (MIT) added.
• GitHub Actions CI: build + unit tests + debug APK artifact on every push/PR.
• screenshots/ directory with capture instructions for the README placeholders.
• .gitignore extended to exclude Claude session metadata and keystore files.
• README rewritten with architecture diagram, full feature list, tech stack table, module map, test inventory, screenshots placeholders, and roadmap.