create-ochre
v0.1.0
Published
Scaffold a browser-based creative tool studio — schema-driven canvas apps with seeded determinism, shareable URLs, and agent-ready guidance built in.
Maintainers
Readme
create-ochre
Scaffold a browser-based creative tool studio in one command:
npm create ochre@latest my-studioYou get a complete, production-grade application — not a component pile:
- A working workspace: pan/zoom canvas, auto-generated parameter panels, gesture-perfect undo/redo, presets, randomize, share-by-URL
- Two reference tools: a GPU archetype (procedural shader) and a CPU archetype (image effect in a worker) to copy from
- Deterministic engine: seeded RNG everywhere (
Math.randomfails lint) — identical parameters produce identical pixels on every machine - Real exports: PNG re-rendered at target resolution (GPU-tiled), plus SVG/CSS/token/text code exports where tools offer them
- The full test harness: vitest golden-vector suites + a Playwright matrix (chromium + webkit) with export-determinism assertions, already green out of the box
- Agent-ready guidance:
AGENTS.md(the architecture contract),CLAUDE.md, and skills (add-tool,add-param-kind,verify-tool) that walk an AI coding agent through shipping new tools that hold the quality bar
The core idea
A tool is a typed parameter schema plus one pure render function. The platform derives everything else — controls, share links, undo, presets, randomize, exports, and the shape of its tests. That contract is what makes AI-generated tools reliable: there is almost no surface to get wrong.
Development of this package
node cli/scripts/sync-template.mjs # regenerate template from the app
node cli/test.mjs # scaffold smoke testThe application at the repository root is the single source of truth;
never edit cli/template/ by hand.
