Card generator · free and open source
One design. Every card.
Describe a card once with layers and formulas, fill it from a spreadsheet, and get a PNG for every row. Identical pixels in the browser, on the command line and on a server.
DEV You are looking at the preview of the next version. Back to the release
Design
Shapes, text and images. Any value can be a formula that reacts to the card's data.
"fill": "foil ? #F5C542 : accent"
Fill
Typed params, filled from a JSON or CSV file. One row per card.
title,level,accent
Kuro,5,#0F8F80
Render
Every card to a PNG, a print PDF or a deck sheet: in the editor, from a script or on a server.
yoshida render my-game --out out
Made for card games
Everything on these two cards comes from the forge example: two designs, a few lines of card data and some SVG files.
Icons and bold in card text
Write rules the way they read on the card. Icons wrap with their word.
<b>Action:</b> spend 1 {icon:energy}Rows that measure themselves
Cost coins, pills and chips line up and grow with their text.
"layout": { "direction": "row", "gap": 8 }Gradients
Linear and radial, on any shape, with colours from the card's data.
"gradient": { "angle": 90, "stops": ["#2B5876", "#4E4376"] }SVG art, clipped and optional
Sharp at any size, with rounded corners or a polygon clip. A missing picture can show a placeholder instead of an error.
"src": "{art}", "optional": trueShared components
One effect panel, used by every design of the game.
"include": "components/effect-row.component.json"QR codes with a logo
Link a card to its rules. yoshida warns when a code prints too small.
"type": "qr", "logo_src": "{logo}"Deck sheets and print files
One image per deck for tabletop simulators, or a PDF with bleed and crop marks.
yoshida render my-game --sheet 10x7
What's inside
Visual editor
Drag, resize and rotate layers, preview any card live. Runs in your browser; nothing is uploaded.
Formulas everywhere
Positions, colours and text from expressions, with units like 50%, vw and vh.
Smart text
Word wrap, justify, auto-shrink to fit, line limits with an ellipsis, bold, italic and inline icons.
Repeat and reuse
Draw a layer once per level star or list item; inherit with extends; share layers between designs.
Clear errors
Every problem has a code, file, line and column, often with a "did you mean" hint.
Plain files
A project is a folder of JSON, CSV and images. Version it with git, validate it with JSON Schema.
Start from an example
Four finished projects ship with yoshida. Open one from the editor's project menu, change it, make it yours.
Forge
A small engine-builder card game: icons in text, rows, gradients, SVG art, a shared component.
Poker deck
52 cards, jokers and a back from four designs. Pips placed by formulas.
Cocktails
Recipe cards, a menu and a shopping list at 600 dpi, all from one ingredient list.
Board game
A printable A3 party board: 40 tiles from one repeated group, with bleed for the print shop.
Three ways to start
One core renders everything, so the editor, the command line and the server give you the same pixels.
Editor
Nothing to install. It runs in your browser and saves there; your cards are not uploaded.
Project menu → Forge card gameOpen the editor →
Command line
check, render and fmt for scripts and CI. In the release zip for Linux, macOS and Windows.
yoshida check my-game
yoshida render my-game --out outCLI reference →
Server
Host the editor for yourself or a team, and render big sets on the server.
docker build -t yoshida .
docker run -p 8080:8080 yoshidaServer and Docker →
Quick start · Download and install · Latest release on GitHub
Made for trading cards, game cards, recipe cards, flash cards and name tags: anything where one layout is filled with many sets of values.