Skip to content

docs: AI agent-loop video on landing + AI docs, media optimization - #310

Merged
kevinccbsg merged 1 commit into
mainfrom
docs/ai-loop-video
Jul 24, 2026
Merged

docs: AI agent-loop video on landing + AI docs, media optimization#310
kevinccbsg merged 1 commit into
mainfrom
docs/ai-loop-video

Conversation

@kevinccbsg

Copy link
Copy Markdown
Member

Puts the AI agent-loop demo video to work in the docs, and trims media weight.

What's added

  • Landing (HomePage.vue) — new "Your agent writes tests. TWD makes them run." section, placed after the ecosystem/thesis block so it follows the pitch rather than interrupting it. Muted loop of the silent cut, matching the hero's accessibility contract (reduced-motion poster fallback + play/pause control).
  • AI docs (ai-overview.md) — a "Watch the loop" click-to-play YouTube embed via a new reusable YouTubeEmbed component. It shows the poster and only loads the youtube-nocookie.com iframe on click (no YouTube JS/cookies on page load).
  • SEO (config.mts)VideoObject JSON-LD for the walkthrough.

Performance

  • CLS: reserve aspect-ratio on the loop video + the step screenshot Lighthouse flagged as unsized.
  • Deferred loading: the below-the-fold loop video is preload="none" with no autoplay; it plays via IntersectionObserver when scrolled into view, keeping ~0.65MB off the initial load.
  • Poster: re-encoded the 289KB PNG to a 91KB JPEG sized to the video.
  • Assets: optimized existing PNGs (icons, screenshots, manifest icons) - e.g. web-app-manifest-512x512.png 208KB to 50KB.

Notes

  • Narrated walkthrough: https://www.youtube.com/watch?v=0G6xunet-HI (wired into the landing link, the docs embed, and the JSON-LD).
  • Verify locally with the production build: npm run docs:build && npm run docs:preview.

🤖 Generated with Claude Code

Landing (HomePage.vue): new "Your agent writes tests. TWD makes them run."
section placed after the ecosystem/thesis block. Muted loop is deferred
(preload=none, no autoplay) and played via IntersectionObserver when it
scrolls into view, with a reduced-motion poster fallback and pause control.

AI docs (ai-overview.md): "Watch the loop" click-to-play YouTube facade via a
new reusable YouTubeEmbed component (loads youtube-nocookie only on click).

SEO (config.mts): VideoObject JSON-LD for the narrated walkthrough.

Performance/CLS: reserve aspect-ratio on the loop video and the flagged step
screenshot; re-encode the poster from a 289KB PNG to a 91KB JPEG sized to the
video. Also optimize existing PNG assets (icons, screenshots, manifest icons).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@kevinccbsg
kevinccbsg merged commit f667d6b into main Jul 24, 2026
9 checks passed
@kevinccbsg
kevinccbsg deleted the docs/ai-loop-video branch July 24, 2026 14:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant