Troubleshooting

CLI not found#

Run commands through pnpm from the monorepo root:

pnpm paxfx --help

Enable corepack if pnpm is missing: corepack enable.

Doctor failures#

pnpm paxfx doctor

Doctor checks Node, package managers, Git, FFmpeg, Playwright, config, and cache writability.

Preview will not start#

Confirm the scene validates first:

pnpm paxfx scene validate examples/your-scene/scene.json
pnpm paxfx preview path/to/preview.html

Preview binds to 127.0.0.1 by default.

Rendered checks fail to start#

paxfx check --rendered needs Playwright:

pnpm add -D playwright
npx playwright install chromium

The static paxfx check and the rest of the CLI work without it.

MCP connection errors#

Verify pnpm build succeeded and cwd in MCP config points at your Pax clone. See MCP.

Docs site styling#

Documentation uses Tailwind scoped to /docs/*. Marketing pages use separate CSS. Hard refresh if styles look mixed after upgrades.