blueprint

blueprint turns a conversational web brief into deterministic, portable output.

• The CLI owns presets, validation, preview, deployment, and project metadata.
• The bundled Agent Skill owns preset selection, research, writing, upgrades, and visual review.

Showcase

The examples below show selected Preset outputs. Click a screenshot to open the live Artifact.

| Pitch | Briefing | Archive(Win 98) | | ----------------------------------------------------------------- | ----------------------------------------------------------------------------- | ------------------------------------------------------------------- | | Lathe pitch | Blueprint briefing | Mosoo archive | | Lathe · pitch | Blueprint · briefing | Mosoo · archive |

Install

brew tap samzong/tap
brew trust samzong/tap
brew install blueprint

Homebrew installs Node.js, gofs, and Wrangler as dependencies.

Copy this prompt to your agent:

Install Blueprint and its bundled Agent Skill for your current agent: run brew tap samzong/tap, brew trust samzong/tap, brew install blueprint, and blueprint skill install, then verify the installation with blueprint --version.

Quick start

blueprint create prototype-lite .local/demo
blueprint check .local/demo
blueprint preview .local/demo
blueprint --help

Available presets:

| Preset | Output | Theme model | | ---------------- | ------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- | | pitch | Compiled single-file story | No named Theme; shared design system and fixed Preset baseline | | briefing | Compiled single-file slide deck | Fixed briefing Theme | | slides | Compiled single-file Reveal.js presentation with optional brand/language chrome and speaker notes | Configured dify-x Theme; currently the only supported value | | archive | Compiled searchable Markdown reader | Fixed win98-web Theme | | prototype-lite | Single-file React prototype | No named Theme; Artifact-specific styling on the shared design system | | prototype-full | Vite + React + TypeScript prototype | No named Theme; Artifact-specific styling on the shared design system | | dossier | Maintained Vite + React + TypeScript report | No named Theme; Artifact-specific styling and entity color strategy |

A Preset is the Artifact contract, not a visual style. Only slides currently exposes a Theme field; briefing and archive use fixed Themes. See CONTEXT.md for canonical terminology and ownership.

Every successful create writes .blueprint.json with the project identity, entry point, preset, last verified preset version, and latest verified deployment. Rebuilding preserves the project ID, version marker, and deployment record; the bundled skill advances createdWith only after a verified upgrade.

blueprint list discovers projects under the current directory. Use --root <path> to change the scan root and --json for machine-readable output.

Deploy

Deployment requires Wrangler 4+:

wrangler login
blueprint deploy .local/demo --name repo-task

deploy validates a managed project, publishes it through Cloudflare Workers Static Assets, verifies the URL, and records the result in .blueprint.json.

Single-file presets, including slides, may be deployed from the project directory. For prototype-full and dossier, run pnpm build in the project and deploy its dist directory.

--account is usually unnecessary. blueprint reuses the recorded account, CLOUDFLARE_ACCOUNT_ID, or the only available account. The bundled skill derives Worker names as <repo-name>-<task-name> inside a Git repository and <task-name> elsewhere.

Install the Agent Skill

blueprint skill install

The installer uses @kitup/sdk to detect supported agents, select user or project scope, and protect unmanaged targets from accidental overwrite. Run blueprint skill install --help for agent, scope, dry-run, and force options.

Development

Development requires Node.js 24+ and pnpm 10.

pnpm install
pnpm check
npm pack

npm pack builds the GitHub Release artifact.

Acknowledgements

blueprint directly uses:

• gofs for single-file local preview serving
• @kitup/sdk for bundled Agent Skill installation
• Wrangler and Cloudflare Workers for deployment

License

MIT