# 🎮 TurboVault

> Your personal video game collection tracker

[![Rails 8.1](https://img.shields.io/badge/Rails-8.1-red.svg)](https://rubyonrails.org/)
[![Gitea](https://img.shields.io/badge/hosted-Gitea-609926.svg)](https://gitea.kazcloud.dev/ryankazokas/turbovault-app)

Track your physical and digital game collection with automatic metadata from IGDB.

## Features

- 📦 Track physical & digital games
- 🎯 Collections & subcollections
- 🔍 Search, filter, sort
- 📊 Statistics dashboard
- 📥 CSV bulk import
- 🎮 IGDB metadata matching
- 🔌 RESTful API

## Quick Start

### Local Development

```bash
# Start services
task docker:up

# Setup database
task db:setup

# Run server
task dev
```

Visit http://localhost:3000

**Demo:** demo@turbovault.com / password123

### Deploy to Kubernetes

See [INITIAL_DEPLOYMENT.md](INITIAL_DEPLOYMENT.md) for complete setup guide.

**Quick steps:**
1. Build and push first image to Gitea registry
2. Configure k8s secrets and configmap
3. Run `./scripts/deploy-k8s.sh`
4. Configure GitHub Secrets for automation
5. Push tags to deploy: `git tag v1.0.1 && git push origin v1.0.1`

## Tech Stack

- Ruby on Rails 8.1 with Sorbet types
- PostgreSQL with Row Level Security
- Hotwire (Turbo + Stimulus)
- Tailwind CSS
- Solid Queue for background jobs

## Documentation

- [Quick Start](docs/QUICK_START.md) - Getting started guide
- [Development](docs/DEVELOPMENT_GUIDE.md) - Local development
- [API Docs](docs/API_DOCUMENTATION.md) - RESTful API reference
- [Deployment](docs/DEPLOYMENT.md) - Production deployment

## Commands

```bash
task dev          # Start dev server
task test         # Run tests
task lint         # Check code style
task lint:fix     # Auto-fix style issues
task typecheck    # Run type checker
```

## License

MIT - See [LICENSE](LICENSE)