Skip to content

PROGRESS.md

Latest commit

 

History

History
56 lines (43 loc) · 2.99 KB

PROGRESS.md

File metadata and controls

56 lines (43 loc) · 2.99 KB
Raw

PROGRESS.md — project status

Live status for contributors and agents. For the working agreement (repo map, recipe schema, golden path, hard rules) read AGENTS.md first. Roadmaps live in ROADMAP.md (HTML line) and VIDEO-ROADMAP.md (video line).

Where the product stands (v0.1)

Two product lines, both closed-loop:

  • HTML line — generate an animated single-file page from one sentence, then edit motion per component on the running page: 4 triggers (load / scroll / hover / click), 13 motion verbs, spring easing, a keyframe editor (6 tracks, scrub + auto-keyframe, serializes back into the page), reusable motion styles, and export as JSON / CSS / React / Lottie / MP4 / GIF.
  • Video line — a canvas compositor for launch videos: multi-scene + transitions, per-layer keyframe tracks, kinetic typography (13 char/word presets), motion templates, shared full-movie video backgrounds, in-browser WebCodecs MP4 export (no watermark, no native deps). Agentic generation with a streaming plan → execute → self-review loop.

Engines (8): Claude Code, Codex CLI, Cursor Agent, OpenCode, Grok Build, Hermes, Gemini CLI (local CLIs), Open Design Cloud (ACP over stdio via vela), plus BYOK (direct Anthropic / OpenAI / Google API calls with your own key). Each drives the same generation/edit pipeline; see KNOWN_CLIS in cli/bin/motion.js.

Library: 400+ curated recipes across ambient / feedback-delight / interaction categories — including 35 faithful dependency-free ports of distinctive GPU/canvas effects (see ATTRIBUTION.md) — plus 58 design-system brand packs, 58 video templates, 112 HTML prototype templates, and an icon library. Every recipe is an Open-Design-compatible SKILL.md and obeys the restraint budget in MOTION-SPEC.md.

How to run

node cli/bin/motion.js serve 4399
# open http://localhost:4399

Requirements: Node 18+. Pick an installed agent CLI (or configure BYOK) in Settings → Execution mode. Changing cli/bin/motion.js requires a server restart; app/* changes only need a browser refresh.

Known limitations (honest list)

  • HTML→MP4/GIF export rasterizes via SVG foreignObject: CSS/DOM/SVG and same-origin images capture fine; live <canvas>/WebGL/<video> backing stores do not (use the per-canvas recorder or the video line for those).
  • Four react-bits effects (Beams, Ballpit, Hyperspeed, LiquidEther) remain reference cards — they need three.js-scale engines and a dependency-free port isn't worth the fidelity loss.
  • BYOK is non-streaming (one reply per turn); local CLI engines stream.
  • The preview iframe requires same-origin (served by the bundled server, not file://).

Contributing

Add a recipe: follow the golden path in AGENTS.md (folder + recipe.motion.yaml + self-contained preview.html + implementation + SKILL.md), register it in app/data/recipes.js, and verify the preview renders before opening a PR.