mirror of
https://github.com/ryankazokas/turbovault-app.git
synced 2026-04-16 22:12:53 +00:00
Ryan Kazokas
69993a3bf5
- Switch from Gitea to GitHub Container Registry (ghcr.io) - Add GitHub Actions workflow with Tailscale connectivity - Update k8s manifests for cloud nodes and Traefik ingress - Configure for turbo.kazcloud.dev domain - Test deployment with home page text change
78 lines
1.8 KiB
Markdown
78 lines
1.8 KiB
Markdown
# 🎮 TurboVault
|
|
|
|
> Your personal video game collection tracker
|
|
|
|
[](https://rubyonrails.org/)
|
|
[](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)
|