My Personal Projects

← Back to home

Game Vault

An Android app for managing your board game collection. Scan your game shelf with AI-powered detection, enrich with BoardGameGeek data, and track what you own and play.

Features

AI-Powered Shelf Scanning

• Photograph your board game shelf and let AI identify the games
• Supports multiple AI providers (Claude, OpenAI)
• Review and confirm detections before adding to your collection

BoardGameGeek Integration

• Automatic matching against BGG's database
• Pulls ratings, player counts, playing time, weight, categories, and mechanics
• Downloads and caches box art images locally

Collection Management

• Track games you own, want (wishlist), or have played elsewhere
• Personal ratings (1-10)
• Mark games as played with play history logging
• Add custom notes
• Upload your own "nice photo" of the game box
• Tag games with custom labels

Smart Filtering

• Search by title
• Filter by player count, playing time, complexity, played status
• Filter by BGG categories and mechanics
• Sort by name, rating, recently added, or recently played

Statistics

• Collection overview and play history
• Most played games
• Rating distributions

Privacy-Focused

• Offline-first architecture
• All data stored locally on device
• API keys stored securely in Android Keystore
• No cloud sync or tracking

Screenshots

Coming soon

Tech Stack

Category	Technology
UI	Jetpack Compose, Material 3
Navigation	Navigation Compose
Database	Room (SQLite)
DI	Hilt
Networking	Ktor Client
Images	Coil, CameraX
Serialization	Kotlinx Serialization
Security	EncryptedSharedPreferences

Requirements

• Android 10 (API 29) or higher
• Camera permission for shelf scanning
• Internet for AI analysis and BGG lookups (optional after initial setup)

Building

# Clone the repository
git clone https://github.com/yourusername/board-game-categorizer.git
cd board-game-categorizer

# Build debug APK
./gradlew assembleDebug

# Install on connected device
adb install -r app/build/outputs/apk/debug/app-debug.apk

Configuration

AI Provider Setup

The app supports two AI vision providers for shelf scanning:

1. Claude (Anthropic)

   • Get an API key from Anthropic Console
   • Enter in Settings > AI Provider > Claude API Key

2. OpenAI

   • Get an API key from OpenAI Platform
   • Enter in Settings > AI Provider > OpenAI API Key

Backup & Restore

• Configure auto-backup folder in Settings
• Backups include: games, tags, play sessions, and all metadata
• JSON format for easy portability

Architecture

The app follows Clean Architecture principles:

┌─────────────────────────────────────┐
│              UI Layer               │
│  (Compose Screens + ViewModels)     │
├─────────────────────────────────────┤
│           Domain Layer              │
│   (Models, Business Logic)          │
├─────────────────────────────────────┤
│            Data Layer               │
│  (Room, AI Providers, BGG Client)   │
└─────────────────────────────────────┘

Project Structure

app/src/main/java/ch/sbebe/boardgames/
├── ai/                 # AI vision provider abstractions
├── bgg/                # BoardGameGeek API client
├── data/
│   ├── backup/         # Backup/restore functionality
│   ├── local/          # Room database, DAOs, entities
│   ├── repository/     # Data repositories
│   └── settings/       # App preferences
├── di/                 # Hilt dependency injection modules
├── domain/
│   └── model/          # Domain models
├── navigation/         # Navigation graph
├── ui/
│   ├── components/     # Reusable Compose components
│   ├── detail/         # Game detail screen
│   ├── inventory/      # Main inventory list
│   ├── scan/           # Camera and scan results
│   ├── settings/       # Settings screen
│   ├── stats/          # Statistics screen
│   └── theme/          # Material theme
└── util/               # Utilities and helpers

Contributing

Contributions are welcome!

Acknowledgments

• BoardGameGeek for the comprehensive board game database
• Anthropic and OpenAI for AI vision capabilities

← Back to home