# 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 `
`. 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 `` 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 ```sh 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.