Files
hyperframes/packages/cli/src/docs/troubleshooting.md
T
Vance Ingalls 20be2ea1c2 style: apply oxfmt baseline formatting across all source files (#25)
## Summary
- Run `oxfmt .` across the entire codebase to establish formatted baseline
- 299 files changed — mechanical formatting only, no logic changes
- Double quotes, semicolons, 2-space indent, trailing commas, 100 print width

Part 3/4 of [VA-851](https://linear.app/heygen/issue/VA-851/pre-migration-configure-eslint-prettier-and-conventional-commits)

## Test plan
- [x] `pnpm format:check` — all 426 files pass
- [x] `pnpm -r typecheck` — all packages pass
- [x] `pnpm build` — all packages build
- [x] All 348 tests pass
2026-03-23 17:15:14 -07:00

849 B

Troubleshooting

"No composition found"

Your directory needs an index.html. Run npx hyperframes init to create one.

"FFmpeg not found"

Local rendering requires FFmpeg. Install it:

Lint errors

Run npx hyperframes lint to check for common issues:

  • Missing data-composition-id on root element
  • Missing class="clip" on timed elements
  • Overlapping timelines or invalid data attributes

Preview not updating

Make sure you're editing the index.html in the project directory. The preview server watches for file changes and auto-reloads.

Render looks different from preview

Use --docker mode for deterministic output. Local renders may differ due to font availability and Chrome version.