An Ink component library for building card games in the CLI. Cards, decks, hands, game state — everything you need to go from idea to playable prototype.
Loading interactive storybook...
Cards, layouts, state management, and a hook-based game engine — all for the terminal.
Render standard, mini, unicode, or fully custom cards. Pick from simple, ASCII, or minimal styles — each with its own character.
Group cards into stacks and decks. Fan them out horizontally, stack vertically, or overlap however you like.
Lay cards out in rows and columns. Control spacing, alignment, and how empty slots get filled.
DeckProvider gives you zones — draw pile, hands, discard, play area. Per-player hands and immutable state out of the box.
Design your own cards with structured regions (header, art, body, footer) or go freeform. Five size presets, custom backs.
Hook into draws, plays, and shuffles. Chain effects together — conditional, triggered, delayed, or targeted.
Install, import, deal. That's it.
1. Install
$ npm install ink-playing-cards ink react2. Deal some cards
Loading live demo...
These are real Ink components running live in your browser. Click a terminal to play with it.
Ships with an Agent Skill so your coding agent knows the full API, architecture, and patterns — no hallucinated imports.
Install the skill
npx skills add gfargo/ink-playing-cardsWorks with Claude Code, Cursor, Kiro, Copilot, Codex, Amp, Goose, and any agent that supports the open skills spec.
What your agent gets