A comprehensive web-based collection management system for Magic: The Gathering cards across multiple platforms.

• 📦 Multi-Platform Support: Track collections in Paper, MTG Arena, and MTG Online
• 🎯 Smart Imports: Support for Moxfield, Manabox, CSV, and direct MTGA/MTGO integration
• 📍 Physical Location Tracking: Know exactly where your paper cards are (decks, binders, storage)
• 🎴 Decklist Management: Store and organize your decklists
• 🔄 Delta Imports: Efficiently update collections with only changes
• 🌐 Web & Mobile: Responsive design with future native mobile app support
• 🔐 Secure Authentication: Your collection data is private and secure
• 💰 Learning Project: Azure-hosted with <$150/month budget for exploring cloud services

1. Visit the website: https://example.com (domain TBD - coming soon)
2. Create an account: Sign up with your email
3. Import your collection:
   • Paper: Upload CSV from Moxfield, Manabox, or other platforms
   • MTG Arena: Download and run our Windows desktop client
   • MTG Online: Export collection and upload the file

The MTG Arena desktop client automatically extracts your collection from MTGA log files:

1. Download: Latest Release
2. Run the installer
3. Enable in MTGA: Settings → Account → "Detailed Logs (Plugin Support)"
4. Launch the MTG Collection Tracker client
5. Click "Sync Collection" - logs are read and uploaded automatically

How it works: The client reads log files that MTGA writes locally using the official "Plugin Support" feature. Same method used by 17Lands and other popular trackers.

Requirements: Windows 10/11 or macOS, MTG Arena installed

Safety:

• ✅ ToS-compliant (explicitly authorized by Wizards)
• ✅ No code injection or memory modification
• ✅ Zero account termination risk
• ✅ Used by 17Lands, MTGA Assistant, and other endorsed tools

• Frontend: Blazor WebAssembly (.NET 10), Bootstrap CSS
• Backend: ASP.NET Core 10 Web API, PostgreSQL
• Desktop Client: Avalonia UI (.NET 10) with auto-update via Velopack (future)
• Hosting: Azure (Static Web Apps + App Service)
• Infrastructure: Azure Bicep (Infrastructure as Code)

🚧 In Active Development - Not yet publicly available

Current phase: Phase 3 - Scryfall Integration & Card Management

Completed:

• ✅ Authentication (Register, Login, JWT + Refresh Tokens)
• ✅ Collections CRUD (view, add, edit, delete with pagination and filtering)
• ✅ Card search and detail pages (Scryfall data integration)
• ✅ Database schema (Users, Cards, Collections)
• ✅ 147 tests (138 passing, 9 skipped pending HTTP mocking)

Next:

• 🔄 Import/export features (Moxfield CSV, Manabox CSV)
• 🔄 Card details modal enhancements
• 🔄 Azure deployment & CI/CD (Phase 4)

See ROADMAP.md for detailed progress.

• .NET 10 SDK
• PostgreSQL 14+ (or Docker for local development)
• Azure CLI (for deployments - optional for local dev)
• Visual Studio 2022 or VS Code

# Clone repository
git clone https://github.com/Datyedyeguy/mtg-collection-tracker.git
cd mtg-collection-tracker

# Start PostgreSQL (Docker)
docker compose up -d

# Backend API
cd src/backend/MTGCollectionTracker.Api
dotnet restore
dotnet run --launch-profile https

# Frontend (in new terminal)
cd src/frontend/MTGCollectionTracker.Client
dotnet restore
dotnet run --launch-profile https

# Desktop Client (future - Phase 4)
cd src/desktop/MTGALogParser
dotnet restore
dotnet run

See docs/DEVELOPMENT.md for detailed setup instructions.

┌─────────────┐
│   Browser   │
│  (Blazor)   │
└──────┬──────┘
       │ HTTPS
       ▼
┌─────────────────┐         ┌──────────────┐
│ Static Web App  │         │   Desktop    │
│   (Frontend)    │         │   Client     │
└─────────────────┘         │  (Avalonia)  │
       │                    └──────┬───────┘
       │                            │
       │ REST API                   │ MTGA Log Parsing
       ▼                            ▼
┌─────────────────┐         ┌──────────────┐
│   App Service   │         │  MTG Arena   │
│  (.NET 10 API)  │         │  Log Files   │
└────────┬────────┘         └──────────────┘
         │
         ▼
┌─────────────────┐
│   PostgreSQL    │
│   (Card Data +  │
│   Collections)  │
└─────────────────┘

See docs/ARCHITECTURE.md for detailed system design.

This is a personal learning project. See CONTRIBUTING.md for details.

Monthly Azure costs (with optimizations):

• Azure App Service (Linux B1): ~$13/month
• PostgreSQL Flexible Server (B1ms): ~$12/month
• Blob Storage: ~$1/month
• Total: ~$26/month ($312/year)

With Visual Studio Enterprise subscription: Effectively FREE (includes $150/month Azure credits)

• ✅ Passwords hashed with BCrypt
• ✅ JWT-based authentication
• ✅ HTTPS enforced everywhere
• ✅ SQL injection prevention (EF Core parameterization)
• 🔄 Rate limiting on API endpoints (planned - Phase 5)
• 🔄 Secrets stored in Azure Key Vault (planned - Phase 4)

Found a security issue? Please report it responsibly via GitHub Security Advisories (do not open public issues for security vulnerabilities).

This project is licensed under the MIT License - see LICENSE for details.

• Scryfall for comprehensive MTG card data API
• Wizards of the Coast for Magic: The Gathering
• Original MTGA collection exporter code from MTGArenaCollectionExporter

• Phase 1: Project setup and architecture
• Phase 2: Backend API with authentication
• Phase 3: Scryfall integration & card management (in progress)
• Phase 4: Azure deployment & CI/CD
• Phase 5: Import/export features
• Phase 6: Desktop MTGA client
• Phase 7: Decklist management
• Phase 8: Physical location tracking
• Phase 9: Mobile apps
• Phase 10: Advanced search and statistics

• Documentation: docs/
• Issues: GitHub Issues
• Discussions: GitHub Discussions

Made with ❤️ for the MTG community