vawe-page
Write an HTML page that renders to an mp4 video, programmatic video and motion graphics as code with CSS, SVG, canvas or three.js. Author a vawe page film: one films/<name>/page.html the renderer seeks frame by frame. Load before writing or editing any page.html: audio tags, the spring helpers, and the page-code mistakes a first draft makes. The page contract itself is in AGENTS.md.
vawe-hq · Static checks on file
Installation
Read the source and dependencies before running a command. Copying does not install or execute anything.
npx skills add vawe-hq/vawe --skill vawe-pageAbout this skill
name: vawe-page description: "Write an HTML page that renders to an mp4 video, programmatic video and motion graphics as code with CSS, SVG, canvas or three.js. Author a vawe page film: one films//page.html the renderer seeks frame by frame. Load before writing or editing any page.html: audio tags, the spring helpers, and the page-code mistakes a first draft makes. The page contract itself is in AGENTS.md." effort: medium license: Apache-2.0
vawe-page: write the page
Run this skill inside a vawe checkout: AGENTS.md, taste/ and bin/vawe live there. With no checkout, get one: git clone https://github.com/vawe-hq/vawe.git && cd vawe && npm install && bin/vawe-dev doctor.
A film is one HTML page; the renderer seeks it, screenshots every frame and mixes the audio offline.
The contract is in AGENTS.md, its details under "Contract details" below. Start with bin/vawe new <name>;
this skill holds the code a first draft gets wrong. Taste pitfalls: taste/build/DIGEST.md. The order of the stages and the doc for each is the loop table in AGENTS.md; each verb's next: line names the next one.
Design system and kit (stage 3)
Write films/<name>/DESIGN.md and films/<name>/kit/: ground layers, and each moving part (word, mark, bar, card, icon,
wordmark) as its own element. Start from a PROVEN combo in prompts/skill-combos.md (record Combo: <name>; swap at most one rung, with a reason). The skill ladder, one skill per rung in order (command npx -y ui-skills get <slug>):
builder (leonxlnx/soft-skill or emilkowalski/emil-design-eng: the product UI and kit parts as a real, beautiful interface),
type (jakubkrehel/better-typography or pbakaus/typeset), colour (pbakaus/colorize or jakubkrehel/better-colors),
depth (mengto/beautiful-shadows or mengto/progressive-blur), then frame: compose the video frame with vawe's own rules
(about 1 line and 2 or 3 things, ground never flat, an eye path). The frame rejects web-page patterns (nav, CTA button, pill,
eyebrow, section padding), never by skipping the builder rung. Write one DESIGN.md line per rung: Skill <rung>: <slug>: what it decided, or Skipped <rung>: <reason>, a reason that cites a reference frame path or a SPEC.md line (bin/vawe advises on a missing rung). Product UI inside the film is a designed
interface with real-looking data, never placeholder bars. For an invented product the UI is invented but designed.
An owner decision that differs from a house default goes under ## Declared in DESIGN.md, one - key: value line each: font, type-scale (percent cap height of read text), ui-scale (percent for UI that is the subject, put in a data-ui element), camera (still or free). The acceptance rows and the judge follow the line and print it (harness/lib/design-decls.mjs).
DESIGN.md also names colour roles (ground, text, muted, one scarce accent, positive, negative), type roles (mono for every numeral; the measured brand weights) and a negative list (no nav or footer chrome, no second accent, no back, bounce or elastic easing unless the brand is a toy brand).
Kit format: kit/kit.css holds :root tokens (palette roles, light positions) and one rule per part (.ground-*,
light devices, .grain, .lockup, .word, .line), each moving part its own element; kit/kit.html is an optional
sheet that shows every part once. Example: films/examples/colour-sting/DESIGN.md and kit/.
Board and motion (stages 4 to 7)
Each data-world is a static state from the kit first (bin/vawe frame <page> --world all): about 1 line and 2 or 3 things, a ground that is never flat (a light, grain or depth device named from a reference frame, changed at each world turn). --world shoots each still at the world's data-key="4.2" (film seconds) when set, else at its quietest second (least movement; a move that runs through the whole world is left out), and prints the second and why.
The Board is a plan for time, not frames: rhythm (cuts not all equal: one under 0.4 s, one over 0.9 s), the spectacle second (also <meta name="spectacle">; recipe 15 in prompts/moves/RECIPES.md), a named move per cut (overlap, camera, what carries the eye, which arrivals overshoot: EASE.nudge for ordinary ones, EASE.pop for the hero), a handoff per cut (vawe-transitions), and sound (below). Ideas first: guides/IDEATE.md.
The camera holds still by default and moves only with a reason (the spectacle, a reveal): a hold stays alive through an element motion (typing, a counter, a glint), not a camera drift. The motion is done when overshoot-share, live-hold, constant-camera and seam-variety are clean or waived with a reason, every cut is Read (bin/vawe frame <page> --cuts; on the spectacle second --moment <s> --onion and --velocity) against taste/craft/motion-craft.md and core/motion/README.md, and each cut has a "Motion pass" row.
A film that uses the lens (core/surfaces/lens.js, prompts/moves/lens.md; every look, option and default in skills/vawe-page/API.md) picks its look by sight: bin/vawe frame <page> --looks --at <s> shows the page under every look, then set look: '<name>' in the lens options.
<meta name="message" content="zero fees"> <!-- the one thing to remember -->
<meta name="spectacle" content="6.2"> <!-- the second of the one big moment; quiet before it -->
<audio src="assets/click.wav" data-on="land:#can"></audio> <!-- a recorded effect on the frame #can lands; a loop src only if the user gives a track -->
<audio src="assets/close.wav" data-on="leave:#can" data-at="-0.03"></audio> <!-- its exit, one frame early -->
<audio data-synth="pluck" data-at="0.85"></audio> <!-- a quiet tick on one key word, default gain -->
<audio data-synth="swell" data-at="1.66"></audio> <!-- the one soft swell, ends on the cut -->
<audio src="assets/vo.wav" data-role="vo" data-at="1.0"></audio>
Tie each effect to its action with `data-on="start:
Read the complete source ↗