# GrimDeck

> Free MTG deck builder, collection tracker, and card database.

GrimDeck is a web application for managing Magic: The Gathering card collections. It provides comprehensive card data sourced from Scryfall, covering every English-language MTG card ever printed.

## Key Features

- **Card Database**: Browse 100,000+ unique card printings across 1,000+ sets
- **Collection Tracking**: Track owned cards with condition, finish, and purchase price
- **Deck Builder**: Build and analyze decks for all formats (Commander, Standard, Modern, Pioneer, Legacy, Vintage, Pauper, and more)
- **Curated Lists**: Create shareable ranked or categorized card lists
- **Precon Database**: Browse official preconstructed decks (Commander, Challenger, Starter, etc.)
- **Advanced Search**: Full-text search with filters for color, type, format legality, price, mana cost, power/toughness, rarity, and more
- **Mana Analysis**: Frank Karsten mana base mathematics for deck optimization
- **Price Tracking**: TCGplayer market prices updated daily

## Page Types

### Card Pages
- URL pattern: /card/{setCode}/{collectorNumber}/{slug}
- Example: [Jin-Gitaxias, Progress Tyrant](/card/neo/226/jin-gitaxias-progress-tyrant)
- Contains: Card image, oracle text, type line, mana cost, format legalities, prices across vendors, rulings, all printings

### Set Pages
- URL pattern: /sets/{code}
- Example: [Kamigawa: Neon Dynasty](/sets/neo)
- Contains: Complete card list for a set with filtering by color, rarity, and type

### Set Index
- URL: /sets
- Contains: All MTG sets organized by release date and type

### Precon Pages
- URL pattern: /decks/precon/{code}/{slug}
- Example: [Buckle Up Commander Deck](/decks/precon/neo/buckle-up)
- Contains: Full preconstructed deck list with card images, mana curve, color identity, and price

### Precon Index
- URL: /decks
- Contains: All official preconstructed decks organized by set and type

### Search
- URL: /search
- Supports: Name, oracle text, type, color, color identity, mana cost, CMC, power, toughness, rarity, set, format legality, price range, keywords
- Syntax guide: [Search Syntax](/search/syntax)

### Secret Lair Drops
- URL pattern: /secret-lair-drops/{code}/{slug}
- Contains: Secret Lair product details with card lists and pricing

### Blog
- URL: /blog
- Individual posts: /blog/{slug}
- RSS feed: /blog/rss.xml
- Contains: MTG strategy guides, set reviews, budget picks, tribal deep dives, format staples, and deck building tips
- Posts link extensively to card pages and include inline card images

## Data Sources

- **Card Data**: [Scryfall](https://scryfall.com) — updated daily
- **Precon Data**: [MTGJSON](https://mtgjson.com)
- **Pricing**: TCGplayer via Scryfall
- **Commander Popularity**: EDHREC rankings