tcgvault v0.1
v0.1.0 — Open Source · MIT License

Track your TCG collection.
Know your worth.

Free, open source, self-hostable. Works with Pokemon, MTG, Yu-Gi-Oh!, Lorcana, One Piece, SWU, Flesh and Blood, Pokemon Japan.

8
Games
300,000+
Cards
100%
Open Source
None
Zero Backend
tcgvault — collection tracker
$ git clone https://github.com/TCG-Price-Lookup/tcgvault
$ cp .env.example .env # add TCG_API_KEY
$ npm install && npm run dev
Server running at http://localhost:4321
API key loaded from .env
Ready to track 300,000+ cards
Collection total: $0.00

Why tcgvault?

🎮

Multi-game

8 trading card games in one place. Switch between Pokemon, MTG, Yu-Gi-Oh!, and more.

📈

Live pricing

Real-time card values via the TCG Price Lookup API. Market, per-condition, and graded prices.

🔒

Env var config

Set TCG_API_KEY in .env once. Your API key stays server-side, never exposed to the browser.

📤

Export anywhere

Export your collection to JSON or CSV. Your data, your format.

🚀

Self-hostable

Deploy to Cloudflare Pages, Vercel, Netlify, or run it in Docker. 5 minutes to ship.

Open source

MIT licensed. Fork it, customize it, make it yours. PRs welcome.

How it works

01

Get a free API key

Sign up at tcgpricelookup.com. Free tier includes 200 requests/day, no credit card required.

Get your key →
02

Set your env var

Add TCG_API_KEY to your .env file (local) or your deploy platform settings.

03

Deploy and track

Deploy in one click. Open your tcgvault, add cards, track collection value.

Deploy in 60 seconds

One-click deployment to your favorite platform.

# Run locally
git clone https://github.com/TCG-Price-Lookup/tcgvault
cd tcgvault && cp .env.example .env
# Add TCG_API_KEY to .env
npm install && npm run dev

Frequently Asked Questions

Do I need to pay to use this?

No. tcgvault is free and open source (MIT). The TCG Price Lookup API has a free tier with 200 requests/day — no credit card required. Upgrade to Trader ($14.99/mo) for higher limits, eBay prices, graded values, and price history.

Where is my data stored?

Your collection list is stored in your browser's localStorage. Card price data comes from the TCG Price Lookup API via your own server (with your API key). No third parties see your data.

How do I set my API key?

Add TCG_API_KEY to your .env file when running locally, or to your deployment platform's environment variables (Cloudflare Pages, Vercel, Netlify all support this in their dashboard).

Which games are supported?

All 8 games supported by TCG Price Lookup: Pokemon, Pokemon Japan, Magic: The Gathering, Yu-Gi-Oh!, Disney Lorcana, One Piece, Star Wars: Unlimited, Flesh and Blood.

Is my API key safe?

Yes. Your TCG_API_KEY is only used server-side (in Astro API routes or Cloudflare Workers). It is never exposed to the browser or included in any client-side bundle.

Can I contribute?

Absolutely. tcgvault is MIT licensed on GitHub. Open issues, submit PRs, or fork it and make it yours.

Ready to track your collection?

Deploy in 60 seconds. Free API key included.

Get Started GitHub