cyxj-hyperframes
chenyuxiaojin/cyxj-hyperframes
HTML + GSAP para vídeos tutoriais renderizados em MP4, sem React pesado
Ver no GitHubToolkit open-source para criar vídeos tutoriais com HTML + GSAP renderizados em MP4 via HeyGen HyperFrames. Inclui 10 projetos arquivados, 7 componentes reutilizáveis e documentação sobre restrições hard e workflow com Claude Code.
Instalação
npx convez-ai chenyuxiaojin/cyxj-hyperframes1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Produzir vídeos tutoriais de programação com source code reutilizável
- Criar animações web renderizadas em MP4 sem Remotion
- Documentar workflows Claude Code + OpenAI Codex em vídeo
Veredito

Solução pragmática para devs que querem render vídeos com skills web conhecidas. A documentação rigorosa (hard constraints, style playbook) e os 10 projetos reais tornam o repositório uma referência legítima, apesar do escopo específico em video production.
README
A tradução para o português deste README ainda está na fila.
English | 中文文档
cyxj-hyperframes
cyxj-hyperframes is a collection of open-source HTML+GSAP video projects and a reusable toolkit for making Claude Code tutorial videos, built on HeyGen HyperFrames.
Demo
Featured video: 19 Claude Code Tips — 7.5 min / 28 compositions / full source at 视频项目/已发布/2026-05-04-claude-19-tips/
Why
Most video-making tools for developers either require heavyweight React knowledge (Remotion) or lock you into proprietary drag-and-drop editors. HyperFrames lets you write HTML + GSAP and renders it to MP4 — same skills you already have.
This repo is the production workspace behind the YouTube channel @cyxj_ai, open-sourced so that:
- You can copy a template and ship a video in an afternoon without knowing motion design
- You can see how Claude Code and OpenAI Codex CLI collaborate on real video projects end-to-end
- The methodology (hard constraints, style borrowing playbook, AI workflow) is written down and reusable
What's Inside
视频项目/已发布/ 10 archived video source projects (each with a README)
视频项目/在制/ active work-in-progress projects (gitignored)
templates/
tutorial-8beat/ The canonical 8-beat tutorial template (cold-start verified 2026-06-11)
components/ 7 reusable components (cc-window, orbit-dots, pulse-bars…)
inspirations/ 5 React UI libraries ported to vanilla HTML+GSAP
catalog.json Machine-readable component catalog (used by skills)
cyxj/
skills/cyxj-hyperframes-overlay/
Active XCYJ overlay: official rules → user layer → project
assets/logos/ 33 AI vendor / tool SVG logos (Claude, OpenAI, GitHub…)
cyxj/docs/
HARD_CONSTRAINTS.md 30 hard constraints distilled from real failures
STYLE_BORROW_PLAYBOOK.md How to legally borrow visual style from reference videos
REFERENCE_INDEX.md Index of upstream reference projects
docs/
hyperframes-official/ 78-page local mirror of HyperFrames official docs
scripts/ Maintenance scripts (refresh catalog, lint projects…)
Quick Start
# 1. Verify the HyperFrames CLI is available (downloads on first run)
npx hyperframes --version
# 2. Copy the template into a dated work directory
DATE=$(date +%Y-%m-%d)
mkdir -p "$DATE"
cp -R templates/tutorial-8beat "$DATE/my-first-video"
cd "$DATE/my-first-video"
# 3. Edit meta.json: change the `id` field to something unique
# 4. Edit index.html and compositions/*.html: replace {{PLACEHOLDER}} tokens with your content
# 5. Validate and preview
npx hyperframes lint
npx hyperframes preview # opens http://localhost:3002
# 6. Render
npx hyperframes render --quality standard --format mp4 \
--output renders/final.mp4
# 7. When done, archive into 视频项目/已发布/
mv ../my-first-video ../../已发布/$DATE-my-first-video
Full checklist: cyxj/notes/TEMPLATE_USAGE.md
Usage: AI Collaboration Workflow
The intended way to use this repo is to open a Claude Code or Codex session in hyperframes/ and say "make a new video about X". Active discovery now routes through cyxj-hyperframes-overlay: read official/ first for Codex @hyperframes rules, then read cyxj/ for XCYJ assets, templates, visual DNA, and production discipline. The legacy workflow under skills/ remains only as a reference for the loop:
- Ask for format / topic / duration
- Read
cyxj/docs/REFERENCE_INDEX.mdand recommend 2-3 reference projects - Copy the template into
视频项目/在制/<slug>/, updatemeta.jsonandindex.html - Wait for your script → populate beats → lint → preview
- When you say "done" → auto-archive into
视频项目/已发布/<date>-<slug>/
Claude Code users: active skills are under .claude/skills/, pointing to official/skills/ plus cyxj/skills/cyxj-hyperframes-overlay.
OpenAI Codex users: active skills are under .agents/skills/, pointing to the same official mirror plus XCYJ overlay.
Do not edit official/ by hand; sync it from Codex plugin cache with cyxj/scripts/sync-official-from-codex-cache.sh. Edit XCYJ production rules in cyxj/.
Compared to Alternatives
| cyxj-hyperframes | Remotion (cyxj-remotion) | Motion Canvas | HeyGen student-kit | |
|---|---|---|---|---|
| Language | HTML + GSAP | React + TypeScript | TypeScript | HTML + GSAP |
| Setup | npx hyperframes | npm create video | npm create motion-canvas | same CLI |
| AI-friendly | Yes — plain HTML, prompt-friendly | Harder — React component tree | Moderate | No AI workflow |
| Templates for tutorials | tutorial-8beat + 7 components | None included | None included | Basic examples |
| Skills (Claude/Codex) | Yes | No | No | No |
| Chinese font support | Yes (Noto Sans SC, local woff2) | Yes | Limited | No guidance |
| Output | MP4 via headless Chromium | MP4 via headless Chromium | MP4 | MP4 |
| License | MIT | MIT | MIT | Proprietary |
FAQ
HyperFrames vs Remotion — which should I choose?
HyperFrames: HTML + GSAP, lower barrier, great for narrator-style tutorial videos. Remotion: React + TypeScript, better for data-driven or programmatically generated videos. This repo has a sister project cyxj-remotion for the Remotion pipeline.
I can't write code — can I still use this?
Yes. Copy templates/tutorial-8beat/, find the {{PLACEHOLDER}} tokens in each composition file, and replace them with your text. The template README has a full placeholder table. Claude Code can fill them in for you if you paste the script.
Chinese subtitle rendering issues?
Two known gotchas: (1) Do not use npx hyperframes transcribe for Chinese audio — use whisper-cli directly. (2) Chinese fonts in headless Chromium occasionally fall back if Google Fonts CDN times out — self-host the woff2 files (the karpathy-anthropic project under 2026-05-20/ has a local font bundle you can copy). Full details: cyxj/docs/HARD_CONSTRAINTS.md §4 and §8.
Can OpenAI Codex users use this?
Yes. Skills are symlinked at .agents/skills/ which follows the OpenAI Agents format. Active official skills mirror official/skills/, and the XCYJ overlay points to cyxj/skills/cyxj-hyperframes-overlay. Rebuild official/ from Codex plugin cache, not npx skills update.
License
MIT © 2026 chenyuxiaojin
Acknowledgements
- HeyGen HyperFrames — the HTML+GSAP → MP4 rendering pipeline
- Nate Herk's hyperframes-student-kit — upstream visual inspiration, reference projects, base skill
- GSAP — animation engine
- Claude Code and OpenAI Codex CLI — AI collaboration throughout
