convez.ai
PluginDesenvolvimento WebIntermediário
chenyuxiaojin

cyxj-hyperframes

chenyuxiaojin/cyxj-hyperframes

HTML + GSAP para vídeos tutoriais renderizados em MP4, sem React pesado

Ver no GitHub
InicialPluginScore · de 0 a 100

Toolkit 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-hyperframes

1 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

Estrelas
18
Forks
1
Acompanhando
0
Saúde
42%
Último commit
há 2 meses
Versão
—
Issues abertas
0
Contribuidores
1

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.

License: MIT YouTube HyperFrames


Demo

19 Claude Code Tips

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:

  1. Ask for format / topic / duration
  2. Read cyxj/docs/REFERENCE_INDEX.md and recommend 2-3 reference projects
  3. Copy the template into 视频项目/在制/<slug>/, update meta.json and index.html
  4. Wait for your script → populate beats → lint → preview
  5. 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-hyperframesRemotion (cyxj-remotion)Motion CanvasHeyGen student-kit
LanguageHTML + GSAPReact + TypeScriptTypeScriptHTML + GSAP
Setupnpx hyperframesnpm create videonpm create motion-canvassame CLI
AI-friendlyYes — plain HTML, prompt-friendlyHarder — React component treeModerateNo AI workflow
Templates for tutorialstutorial-8beat + 7 componentsNone includedNone includedBasic examples
Skills (Claude/Codex)YesNoNoNo
Chinese font supportYes (Noto Sans SC, local woff2)YesLimitedNo guidance
OutputMP4 via headless ChromiumMP4 via headless ChromiumMP4MP4
LicenseMITMITMITProprietary

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

Ver o original no GitHub

Bom para

Relacionados