# prox.cc — Complete LLM Reference & Documentation

> prox.cc is a free, web-based Magic: The Gathering proxy card generator and deck builder. It converts MTG decklists into print-ready 300 DPI PDF documents scaled precisely to standard physical card dimensions (63×88mm) on A4 and US Letter paper, with support for official precons, top staples, tokens, cubes, and historical printings.

---

## Table of Contents
1. Core Overview & Architecture
2. Physical Card & Paper Dimensions
3. Decklist Syntax & Supported Formats
4. Web Application Routes
5. Public API Reference
6. Frequently Asked Questions & Printing Advice
7. Legal & Playtest Policy

---

## 1. Core Overview & Architecture

prox.cc is built with Next.js 16 (App Router), React 19, TypeScript, Tailwind CSS, and better-sqlite3.
- **Client-Side PDF Generation**: Uses `pdf-lib` to compile high-resolution 300 DPI PDFs entirely within the browser, streaming images via high-speed CDNs.
- **Local SQLite Database**: Includes full card records, tokens, historical printings, and precons indexed locally for sub-millisecond lookups.
- **Zero-Login**: No accounts, credit cards, or logins required.

---

## 2. Physical Card & Paper Dimensions

### Card Dimensions
* Width: `63.0 mm` (`2.4803 inches` / `178.58 pt`)
* Height: `88.0 mm` (`3.4646 inches` / `249.45 pt`)
* Aspect Ratio: `63 : 88` (`0.7159`)
* Cards per Sheet: `9 cards` arranged in a 3×3 grid.

### Paper Formats
1. **A4 (International Standard)**:
   * Sheet Size: `210 × 297 mm` (`595.28 × 841.89 pt`)
   * Grid Width: `3 × 63mm = 189mm`
   * Grid Height: `3 × 88mm = 264mm`
   * Left/Right Margin: `(210 - 189) / 2 = 10.5 mm`
   * Top/Bottom Margin: `(297 - 264) / 2 = 16.5 mm`

2. **US Letter (North American Standard)**:
   * Sheet Size: `215.9 × 279.4 mm` (`612.00 × 792.00 pt` / `8.5 × 11.0 in`)
   * Grid Width: `3 × 63mm = 189mm`
   * Grid Height: `3 × 88mm = 264mm`
   * Left/Right Margin: `(215.9 - 189) / 2 = 13.45 mm`
   * Top/Bottom Margin: `(279.4 - 264) / 2 = 7.70 mm`

### Cut Guidelines & Bleed
* **Cut Marks**: Precision vector hairline crosshairs (`0.5pt`) placed along card boundaries.
* **Dark Corners**: Dark bleed fill placed behind cards to avoid white corner artifacts when cutting with scissors or a rotary trimmer.

---

## 3. Decklist Syntax & Supported Formats

The decklist parser supports standard plain-text formats:
* `4 Lightning Bolt`
* `1x Sol Ring`
* `1 Black Lotus (LEA) 232` (Specifying set code and collector number)
* `1 Sol Ring [SLD:45]`
* Section comments such as `// Commander`, `// Mainboard`, `// Sideboard`, `// Tokens` are automatically parsed.

---

## 4. Web Application Routes

* `https://prox.cc/`: Main interactive proxy builder and PDF compiler.
* `https://prox.cc/decks`: Directory of 670+ Commander Precon decks and EDHREC top commanders.
* `https://prox.cc/decks/[fileName]`: Deck detail view with visual card gallery, mana curve histogram, and 1-click export to builder.
* `https://prox.cc/top-cards`: Metagame staples categorized by Artifacts, Creatures, Instants, Sorceries, Enchantments, Lands, and Salt Scores.
* `https://prox.cc/sets`: Directory of all MTG sets with visual set icon vectors and set card viewers.
* `https://prox.cc/sets/[setCode]`: Set viewer displaying all card printings, rarity filters, and bulk builder import.
* `https://prox.cc/tokens`: Official MTG token viewer with multiplier controls (+1, +4x, +10x).
* `https://prox.cc/cube`: Curated Cube draft decklists.
* `https://prox.cc/about`: Full FAQ, printing guide, and legal policies.

---

## 5. Public API Reference

### 1. Autocomplete Card Search
`GET https://prox.cc/api/cards/search?q={query}`
* Returns: `Array<{ name: string, setCode: string, number: string, imageUri: string }>`

### 2. Historical Printings
`GET https://prox.cc/api/cards/printings?name={cardName}`
* Returns: `Array<{ id: string, set: string, setName: string, collectorNumber: string, imageUri: string, releasedAt: string, rarity: string }>`

### 3. Bulk Card Collection Resolver
`POST https://prox.cc/api/cards/collection`
* Body: `{ cards: Array<{ name: string, count: number, setCode?: string, number?: string }> }`
* Returns: `{ cards: Array<{ name: string, count: number, imageUri: string, setCode: string, number: string, price_usd: number | null }> }`

### 4. Precon Deck Details
`GET https://prox.cc/api/decks/[fileName]`
* Returns: `{ name: string, code: string, releaseDate: string, commander: Array<{ name: string, imageUri: string }>, cards: Array<{ name: string, count: number, imageUri: string }> }`

---

## 6. Frequently Asked Questions & Printing Advice

### How should I print my proxy cards?
1. **Cardstock Method (Professional Feel)**: Print directly on 250 GSM to 300 GSM heavy linen, satin, or matte photo paper. Cut along the lines and sleeve.
2. **Sleeve & Land Method (Budget Friendly)**: Print on standard 80 GSM copy paper, cut along the lines, and slide the paper into a sleeve in front of a real basic land card. The thickness and rigidity will feel identical to a genuine card.

### Printer Settings:
* **Scale**: Always select **"100%"** or **"Actual Size"** in your printer dialog (DO NOT use "Fit to Page" or "Scale to Fit", as this will distort the 63×88mm card size).
* **Quality**: High / Best Photo Quality.

---

## 7. Legal & Playtest Policy

prox.cc is an unofficial fan project and is **not** affiliated with, sponsored by, or endorsed by Wizards of the Coast LLC, Hasbro, Inc., Scryfall, or EDHREC. Magic: The Gathering is a trademark of Wizards of the Coast LLC. All card names, text, and artwork remain the intellectual property of their respective copyright holders.

Proxy cards generated on prox.cc are strictly intended for casual play, cube drafting, deck playtesting, and home entertainment in accordance with Wizards of the Coast's official playtest and proxy policies. Proxies may not be used in sanctioned DCI / Competitive REL tournament play or sold for commercial profit.