One design. Every card.
Design a card once, fill it from a table, export every card. Your cards, your data.
Open the editor · Getting started · Docs · Examples · Download · Dev preview
yoshida is the card creator I always wanted. Way too complicated, way too many possibilities... and now with a functional browser version. Design your cards and just apply the data, press export and happy playing, printing, whatever you wanna do.
Designs are simple JSON files that are easy to share, modify and abuse as much as you want. The editor runs in your browser and your cards stay there. (Rendering on a server is an optional switch for self-hosted setups; only then does your data leave your machine.)
| In the browser | Open https://yoshida.xoyz.dev/editor/, nothing to install. Pick an example from the project menu, change it, export. |
| On your computer | Download the latest release zip (Linux, macOS, Windows), unzip it and run ./start.sh, start.command or start.bat. Then open http://localhost:8080/editor/. |
| With Docker | docker compose up --build, then open http://localhost:8080/editor/. |
| From the command line | yoshida check examples/forge and yoshida render examples/forge --out out (the yoshida program is in the release zip). |
New here? Getting Started takes you to a first card in five minutes.
Dev preview: the
devbranch, with what the next release will bring, is live at https://yoshida.xoyz.dev/dev/ (editor: https://yoshida.xoyz.dev/dev/editor/). It carries a red DEV stamp and is not as well tested as a release.
- A visual editor in the browser: drag, resize and rotate layers, preview every card live
- Layers for shapes, text, images, QR codes and groups (if something is missing, open an issue)
- Formulas in almost every field: positions, colours and text that react to the card's data
- Card text with icons:
<b>Action:</b> spend 1 {icon:energy}just works, and text wraps, shrinks to fit and truncates - Rows and columns that measure their content, for cost coins, pills and chips
- Gradients, SVG art, rounded and clipped images, optional images with a placeholder
- Components: share layers between designs with
include - Card data from JSON or a CSV spreadsheet, one row per card
- Print ready: PNG with dpi, one PDF per set with bleed and crop marks, SVG, or a deck sheet for tabletop simulators (
--sheet 10x7) - Clear error messages with file, line and a hint. Probably the best feature
- The same pixels in the editor, on the command line and on a server
The Feature Tour has a snippet for each of these.
Working projects are in examples/, and in the editor's project menu:
| Example | What it shows |
|---|---|
forge |
A small engine-builder card game: icons in text, rows, gradients, SVG art, a shared component, a QR code. The one to copy for a new project |
poker |
A full deck of 52 cards, jokers and a back from four designs |
cocktails |
Recipe cards, a menu and a shopping list at 600 dpi from one ingredient list |
board-game |
A printable A3 party board built from one list |
The editor exports a whole project (designs, card files, images and fonts) as a single .yoshida file. It is a zip container, like .docx, so you can share it, open it again with Open project file… or by dropping it on the editor, and unpack it with any archive tool after renaming it to .zip. Plain .zip projects from older exports still open. See Saving, Images and Privacy.
The documentation has a page for every feature:
| I want to | Read |
|---|---|
| Make my first card | Getting Started · Installation |
| See what is possible | Feature Tour · Examples |
| Use the visual editor | Builder |
| Write designs by hand | Designs · Params · Layers · Expressions · Card Data |
| Render from scripts, or host it | Command Line · Server and Docker |
| Fix an error | Diagnostics |
| Know what is missing, and where my data goes | Known Gaps · Privacy |
| Work on yoshida | Contributing · Architecture · Testing |
For AI agents: llms-full.txt is the whole file format on one page (also at https://yoshida.xoyz.dev/llms-full.txt), llms.txt the index of the docs, and AGENTS.md says how to build and test.
You need Zig 0.16.0 (or pip install ziglang==0.16.0) and, for the editor, Node 22.
zig build test # unit tests
zig build -Doptimize=ReleaseFast # zig-out/bin/yoshida and zig-out/bin/yoshida-server
zig build wasm # zig-out/web/yoshida.wasm and expr.wasm
cd web && npm install
npm run wasm && npm run examples && npm run dev # editor on http://localhost:5173More in Building from Source.
yoshida bundles a few small libraries so that it builds without any C dependencies installed:
| Library | Used for | License |
|---|---|---|
| stb_image | Loading PNG, JPEG, GIF and BMP images | Public domain / MIT |
| stb_truetype | Reading fonts and drawing text | Public domain / MIT |
| simplewebp | Loading WebP images | BSD-3-Clause |
| Lato | Default font | SIL Open Font License 1.1 |
| Noto Sans Symbols 2 (subset) | Fallback for arrows, shapes, stars and other symbols | SIL Open Font License 1.1 |
The C libraries are single-header files in src/c/. Why they are large and how to update them is described in src/c/README.md.
yoshida is released under the MIT License. Contributions are welcome, see CONTRIBUTING.md.
Looking for the old version (the cursed origin of this)? It lives on as 0.3.1-python.



