Skip to content

kclipsto/proxies-at-home

Repository files navigation

Proxxied — MTG Proxy Builder

Proxxied is a web-based Magic: The Gathering proxy printing tool, designed for printing at home. It lets you easily fetch, arrange, and print high-quality pre-bleeded MTG card images on standard 8.5"×11" sheets, with full cut/bleed guides for accurate trimming. The site is hosted at https://proxxied.com

Features

Card & Image Management

  • Decklist Import — Paste a decklist (1x Sol Ring) and automatically fetch images from Scryfall's API.
  • Alternate Artwork Selector — Choose from multiple art options per card.
  • Custom Image Upload — Upload your own pre-bleeded card images (e.g., from MPCFill Google Drive packs).
  • Caching & Reuse — Uploaded/fetched images are cached locally for faster reprocessing and export.

Print Layout

  • True-to-Size Layout — Cards are placed at the exact 2.5" × 3.5" size with optional bleed edge.
  • Configurable Bleed Edge — Toggle bleed on/off, adjust width (mm), and choose black or mirrored-edge bleed.
  • Cut Guides
    • Primary guides follow your chosen guide color.
    • Edge bleed guides are always black for visibility.
  • Accurate Scaling — 1200 DPI export for professional-quality prints.

PDF Export

  • Multi-Page Support — Automatically paginates when more than 9 cards are selected.
  • Precise Crop Marks — 1px crop marks positioned exactly at the cut edge.
  • High-Resolution Export — jsPDF-powered, preserving full image quality.

Drag & Drop

  • Grid Reordering — Rearrange cards in the 3×3 layout using drag-and-drop.
  • UUID-based Ordering — Keeps layout stable even when cards are added or removed.

Settings Panel

  • Page Size & Columns — Adjust width, height, and grid columns.
  • Guide Width & Color — Customize visual cut guides.
  • Unit Selection — Switch between inches and millimeters.

Theming

  • Dark & Light Mode — Layout preview matches your system theme.
  • PDF Always White — Exports on a white background to avoid color contamination.

📄 Usage

  • Enter your decklist in the left panel.
  • Choose alternate artworks or upload custom images.
  • Adjust bleed edge, guide color, and page size in the Settings panel.
  • Drag cards to reorder in the central 3×3 grid.
  • Click Export PDF to download a high-quality, print-ready sheet.

Tech Stack

  • Frontend: React + TypeScript + TailwindCSS + Flowbite
  • Backend: Node.js + Express (image fetching & caching)
  • Image Processing: Canvas API (client-side bleed edge, scaling, guides)
  • PDF Generation: jsPDF (custom placement & scaling logic)
  • Drag & Drop: @dnd-kit/core

Getting Started

Prerequisites

  • Node.js v18+
  • npm or yarn
  • (Optional) API access for card image sources

Installation (For developers)

# Clone repository
git clone https://github.com/your-username/mtg-proxxied.git
cd mtg-proxxied

There is a ./client and ./server component and they can be run with concurrently via the npm run dev command from the root ./package.json

# Install root dependencies (for concurrently)
npm install

# Install client dependencies
cd client
npm install
cd ..

# Install server dependencies
cd server
npm install
cd ..

# Start development server (run client and server)
npm run dev

Alternatively, with PowerShell

./proxxied.ps1 install
./proxxied.ps1 dev

The the client and server will be running on:

  • Client: http://localhost:5173/
  • Server: http://localhost:3001/

License

MIT — feel free to use, modify, and contribute.

Credits

About

Proxxied is an at home MTG Proxy printing service. Add cards, reorganize, and export to PDF.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 7

Languages