Skip to content

v0.1.0 — first release

Choose a tag to compare

@jbrecht jbrecht released this 10 Jun 21:30
· 14 commits to main since this release

First public release. tutorial-forge turns scripted Playwright walkthroughs into narrated tutorial videos: tutorials are source code — when your UI changes, re-render instead of re-recording.

Install

pnpm add -D tutorial-forge tutorial-forge-cli playwright
npx playwright install chromium
pnpm exec tutorial-forge doctor   # checks node, ffmpeg, browsers, TTS keys

Highlights

  • Three-phase pipeline: TTS → record → post. Narration is synthesized and measured first; the browser holds each step on screen as long as its narration plays.
  • TTS providers: ElevenLabs, OpenAI, Piper (local), Silent (CI) — with a content-hash cache so unchanged lines never re-synthesize.
  • Steps receive the raw Playwright Page; an instrumentation proxy adds an animated cursor and click-highlight callouts without wrapping Playwright's API.
  • Deterministic and CI-friendly: headless, fixed viewport, timing manifest, sidecar SRT subtitles, single-invocation FFmpeg merge.

The attached getting-started.mp4 was generated entirely by this release from the in-repo example app.