Repository navigation
Releases: 4lxn/motion-explainer
Releases · 4lxn/motion-explainer
Release list
v1.5.0: lint catches what spills out when zoomed in
Added
- Lint checks zoomed-in insides (
minZoom): text must fit its box, an inside must not stick out of the element it
sits in, insides of the same element must not overlap, and arrows among them must not pass through boxes. - Lint warns when an arrow is drawn under the box it sits inside (and so is hidden), with the fix.
layeris documented: drawing order from 0 (back) to 3 (front).examples/login-flow: a rich-visuals example from one prompt (hud theme, terminal, icons, zoom, chart, flow hand-offs), with a live demo and a README prompt row.
Changed
- Zoomed-in arrows draw on the box layer, so they show over the box they sit in instead of hiding under it.
- Example scenes must build with zero warnings;
test/run.shfails otherwise.
Fixed
- A flow packet's glow was clipped to a square when zoomed in.
v1.4.0: smooth flow hand-offs
Added
- Narrated demos: What is Microsoft Access? (English) and ¿Qué es Microsoft Access? (Spanish, three voices), with their scenes in
examples/.
Changed
- Flow packets no longer vanish at a component and reappear on the next arrow. When two arrows meet at a component (one multi-arrow flow, or two flows under 2.5 s apart), the packet glides inside, waits while the component's outline fills like a progress ring from where it entered, and glides out onto the next arrow.
- A packet pops out of its source with a small ring, and lands by shrinking into the target with a ripple and a short glow.
- README rewritten: how a request goes, prompts to try, narration languages and voice setup, FAQ.
v1.3.0: native voices per language
Added
- Several voices per explainer:
motion voice <scene> a,b,crenders each, and the player shows a voice picker. - Native voices per language: with no voice given, Spanish narration gets
ef_dora,em_alexandem_santa;
English getsaf_heart. Language comes from the scene'slangor is detected from the narration. - A short pause between sentences in narration.
Changed
- Spanish narration uses Latin American pronunciation (
es-419) by default;lang: 'es-es'for Castilian. motion voicerefuses a voice from another language (it would read with a foreign accent) and names the native ones.- Narrated steps move on when the voice ends, without an extra silent reading pause.
v1.2.0: an explainer made from one prompt
Added
examples/dns-resolution: an explainer the skill made from one prompt, unedited, with a live demo.
Changed
- The contact sheet (
motion shotwith no step) shows each step's full narration instead of cutting it at three lines.
Fixed
motion shot f.html 99silently showed the last step; out-of-range steps now fail with the valid range.- Shot paths no longer contain
//whenTMPDIRends in a slash.
v1.1.1: fixes from verification
Found by an independent verification pass.
Fixed
- Scenes with Windows (CRLF) line endings failed with a misleading CSP error. The build now hashes the text the browser sees.
motion new some/dir/namefailed with a raw bash error when the folder did not exist; it now creates it.- A missing Chrome printed two errors, the second with wrong advice; now one message that points at
motion doctor. test/run.shstops early with a clear message whennodeorpython3is missing.- Docs no longer assume the git-clone path for
motion doctorand the voice setup; plugin installs are covered.
v1.1.0: new, doctor, plugin install, sharper errors
Added
motion new <name> [template]: start a scene from a two-box starter or from an example (architecture,algorithm,idea,story). Never overwrites.motion doctor: checks Chrome,openssl, an end-to-end build and the optional voice setup, with a fix line for each failure.motion --versionand aVERSIONfile.- Install as a Claude Code plugin:
/plugin marketplace add 4lxn/motion-explainer. MOTION_CHROMEto point at any Chrome or Chromium; Linux paths are found automatically.MOTION_SCALE=2for retina-resolutionmotion shotPNGs.- CI on Ubuntu and macOS; issue templates; CONTRIBUTING.md.
Changed
- Lint errors suggest the closest valid name:
unknown type 'bxo'. Did you mean 'box'?(types, verbs, ids, arrow endpoints, icons, eases). - JavaScript errors in a scene report
<scene>.scene.js:<line>instead of a line in the built HTML. motion,motion helpand--helpprint usage on stdout and exit 0; an unknown command is named and exits 2.- SKILL.md finds its files through
${CLAUDE_SKILL_DIR}, so it works from any install location, and starts scenes withmotion new.
Fixed
motion open file.html 12opened a 12x12 window; sizes must beWIDTHxHEIGHT.- Built pages requested
/favicon.ico(a 404 on most hosts). - A scene with no steps crashed the player at boot; it now says what is missing.