Skip to content

Repository files navigation

Catbrary

An app for keeping track of the cats you see around, and for getting info about multiple cat breeds.

Features

  • Track the cats you spot with their photos and details
  • Favorite cats to keep a personal collection
  • Search through your catalog
  • Browse a catalog of cat breeds with photos, temperament, origin, and 1–5 trait ratings (adaptability, intelligence, affection, energy, grooming, and more)
  • Adaptive layout: navigation rail on medium+ screens, bottom bar on compact ones
  • Material 3 Expressive with a warm-amber theme, animated state transitions, and motion-scheme springs
  • Data persisted locally with Room

Screenshots

Screenshot_20260919_134713 Screenshot_20260919_134650 Screenshot_20260919_135333 Screenshot_20260919_135728

Tech Stack

Layer Technology
Language Kotlin (JVM target 11)
UI Jetpack Compose + Material 3 Expressive
Data Room (SQLite), KSP
Networking Volley (The Cat API)
Images Coil
Navigation Navigation Compose
Build Gradle + Android Gradle Plugin

Installation

  • Install the .apk file
  • NOTE: Android 13+ (API 33) required

Building from source

  1. Set your The Cat API key in ~/.gradle/gradle.properties:

    MY_API_KEY=your-key-here
  2. Build the debug APK:

    ./gradlew :app:assembleDebug
  3. The APK is generated at app/build/outputs/apk/debug/app-debug.apk.

Breed trait ratings come from the historical The Cat API dataset and are embedded in the app, since the live API no longer returns those fields.

License

MIT

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages