Docs

Troubleshooting Kavio.

Most issues fall into one of four groups: validation, build setup, browser preview, or the current render-command limitation.

Validation Fails

Check the composition version, required props, asset references, layer ids, timing fields, and export presets. Validate the smallest fixture first, then compare the failing composition.

Preview Does Not Start

Build packages first, then run preview from the repository root. If the printed port is already in use, restart the command and use the new URL.

corepack pnpm run build
node packages/cli/dist/index.js preview examples/basic-json/composition.json

Package Manager Issues

Kavio intentionally uses pnpm with a minimum release age policy. Do not bypass the package-age gate or install fresh dependencies with a client that ignores the repository security posture.

Render Command Missing

This usually means the optional Playwright Chromium browser or FFmpeg binary is not available. Install render binaries, or use preview for visual inspection until the local render environment is ready.