cmotion

cmotion.org

A DSL for video and animation, plus the tools and surfaces around it.

This repository is a monorepo managed with pnpm workspaces.

Layout

cmotion/
├── apps/
│   └── web/          # cmotion.org — Astro site
└── packages/         # shared libraries (future)

Getting started

Requirements: Node.js 20+ and pnpm 10+.

pnpm install        # install all workspace dependencies
pnpm dev            # run the web app (apps/web) in dev mode
pnpm build          # build every workspace package
pnpm check          # run type checks across the workspace

Apps

apps/web — cmotion.org

The marketing site and (eventually) documentation for cmotion, built with Astro. To work on it directly:

cd apps/web
pnpm dev

Roadmap

The language and toolchain are being built in stages, from the parser up to realtime GPU rendering. Each stage should be usable on its own before the next one starts.

• 1. Tree-sitter grammar — parser, syntax highlighting, AST.
• 2. Type system spec — units, asset types, function types, and the determinism partition of stdlib. Lives as a separate document, not in BNF.
• 3. Minimal stdlib — rect, image, mesh3d, compose, animate, oklch, transport, audio analyzers.
• 4. Reference interpreter in Rust — walks the AST directly, no codegen. Lets us exercise the type system and stdlib without committing to WASM yet.
• 5. WASM component codegen — once the language and stdlib are stable, this is mostly mechanical.
• 6. CanvasKit backend — deterministic offline render.
• 7. WGSL codegen — realtime preview on the GPU.

License

MIT — see LICENSE.