Skip to content
CardstockCardstock
Esc
↑↓navigate↵open⌘Jpreview
On this page

Cardstock

Greeting cards an agent makes from a description, opened by link as a 3D paper card.

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 cardstock CLI 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

Last updated on