Skip to content
← Public packages

@kentcdodds/cloudflare-connect-pse-hyperframes

I Built Your Personal Software Ecosystem: Kent C. Dodds's Cloudflare Connect 2026 talk deck, built with HyperFrames. How Kody gives every user one of everything on Cloudflare.

FollowForkOpen app

Files

AGENTS.md

53 lines · 2.7 KB · Markdown

Agent guide: cloudflare-connect-pse-hyperframes

A Kody package app that serves one self-contained HyperFrames slide deck for Kent C. Dodds's Cloudflare Connect 2026 talk. It makes no external requests: no CDNs, remote fonts, hotlinked images or analytics. It declares no credentials, secrets, jobs, webhooks or other capabilities. Keep it that way.

The Reveal.js deck in @kentcdodds/cloudflare-connect-personal-software-ecosystem is the fallback and the content source. Never edit, push to or republish it from here, and never touch the kcd-content repo or its pages.dev deck.

Rules

  • No em dashes (U+2014) anywhere: slides, notes, code comments, docs, commit messages. The build fails on one.
  • Present tense. The build fails if slide text or notes contain "used to", "now", "switched", "removed" or "we moved".
  • Nothing addressed to the speaker appears on a slide. Reminders go in the notes.
  • Reduced motion softens motion and never removes it.
  • app/assets.generated.ts and dist/ are generated. Run npm run build after any change under src/ and commit them with it.

How the deck works

  • scripts/build.mjs turns each src/slides/*.html into a HyperFrames scene: a div.scene-frame[data-composition-id] with data-start and data-duration, wrapping the slide <section class="clip">. A slide with data-steps="N" gets N fragment times in the application/hyperframes-slideshow+json island; the player seeks to them.
  • All scenes sit in one root div[data-composition-id="deck"], and src/runtime.js registers window.__timelines.deck. The player drives that timeline directly, so no HyperFrames runtime loads from a CDN.
  • Elements with data-step="n" show from step n, data-until="n" hide after step n, and data-enter elements stagger in when the slide enters.
  • A slide with a .stage of .node[data-node] elements and <path class="wire" data-from data-to [data-route data-lane data-out]> gets its wires routed at runtime. FLOWS[id] in src/flows.js builds a looping timeline with f.lit, f.send, f.text, f.attr and f.still (the frame ?still shows). STEPS[id] runs on every step change.
  • Don't animate translate on an element GSAP also moves. Put the centering translate on a wrapper.

Checks

npm run lint     # hyperframes lint; the known warnings are file size, track density and repeated images
npm run verify   # every slide, desktop and phone, keyboard nav, no off-origin requests

Publishing

The package repo lives on Kody's git remote. Push there, then publish with the Kody CLI: npx @kodycodes/cli package publish @kentcdodds/cloudflare-connect-pse-hyperframes. Leave visibility settings alone; they are managed separately.