Create custom Munchkin cards with AI-generated artwork. Design, edit, and export your own cards for the beloved board game.
Screenshots coming soon — or try the live demo!
- 🎨 AI Image Generation — Google Gemini creates unique card artwork
- ✂️ Background Removal — Remove.bg integration for clean card images
- 🃏 Multiple Card Types — Monsters, Treasures, Curses, Dungeon Bonuses, and more
- 🖼️ Custom Layouts — Upload and use your own custom card layouts
- 📊 Deck Management — Organize cards by category, track your progress
- 💾 Import/Export — CSV/JSON import, optimized batch PNG export, and BAT (Board A4 Tiled) PDF export
- 🎯 Live Preview & Demo — See your changes as you type, and preview global settings on a live demo card
- 🌍 Multilingual — Full support for English and French, covering both the user interface and card content
- 📱 Responsive — Works on desktop, tablet, and mobile
git clone https://github.com/chichekebbab/cardgenerator.git
cd cardgenerator
npm install
npm run devOpen http://localhost:5173 — that's it!
The app works without any API keys. To enable AI features:
- Click the ⚙️ Settings gear icon in the app
- Add your keys:
- Google Gemini API — for AI image generation
- Remove.bg API — for background removal
- Keys are stored locally in your browser — never sent to our servers
| Frontend | React 19 + TypeScript |
| Build | Vite 6 |
| Styling | Tailwind CSS |
| AI | Google Gemini API |
| Export | html-to-image, JSZip, jsPDF |
cardgenerator/
├── components/ # React components
├── services/ # API services (Gemini, Remove.bg, Sheets)
├── utils/ # Utilities & config
├── tests/ # Unit tests (Vitest)
├── public/ # Card layouts & textures
├── App.tsx # Main component
├── types.ts # TypeScript interfaces
└── .github/ # CI/CD & issue templates
Contributions welcome! See CONTRIBUTING.md for guidelines.
npm run dev # Dev server
npm run lint # Lint check
npm run test:ci # Run tests
npm run build # Production buildThis is an unofficial fan-made tool. Munchkin is a trademark of Steve Jackson Games. This project is not affiliated with, endorsed by, or sponsored by Steve Jackson Games.
MIT — do whatever you want with it.