Overview
Greeting cards an agent makes from a description, opened by link as a 3D paper card.
Cardstock makes greeting cards. You describe the card you want to an agent, such as “a Christmas card for Mum with snow and a photo of the dog”, and it writes the words, picks or makes the pictures, and saves the card. You get a link, and whoever opens it sees an envelope that opens into a paper card, with the effect and music you chose.
You can change any card afterwards in the web app on your phone or computer, and save it as a still, an MP4 or a GIF to send in a chat.
Cardstock is being built in the open on timmo001/cardstock#1. Each page here says what works today and what is still to come.
What it does
- Cards from a description: an agent turns what you ask for into a card, using your own pictures, ones it finds on Openverse or Unsplash, or ones it draws. See Making a card.
- Private links: a card opens only for whoever holds its link. The card is encrypted before it leaves your device, and the server never sees the key. See Links and privacy.
- A 3D paper card: the envelope, the fold and the paper are drawn with three.js on WebGPU, falling back to WebGL. With reduced motion on, the card shows still and open.
- The web app: your cards, their links and your devices, installed on a phone or computer. See The web app.
- For agents: the
cardstockCLI with Code Mode and MCP, and a skill that tells an agent how to use them. See CLI and Agents.
Parts
| Part | What it is |
|---|---|
packages/card |
The card format, encryption, renderer, designs, effects and export |
packages/app |
The web app, with the viewer and editor |
packages/server |
The Cloudflare Worker that stores encrypted cards |
packages/cli |
The cardstock CLI, with Code Mode and MCP for agents |
docs |
This site |
Machine-readable docs
| URL | Use |
|---|---|
| https://cardstock.timmo.dev/llms.txt | Compact page index |
| https://cardstock.timmo.dev/llms-full.txt | Full docs bundle |
| https://cardstock.timmo.dev/mcp | Hosted MCP (search, page and navigation) |
/{route}.md |
One page as Markdown |