Troubleshooting

"No scene found with name"

• Confirm exact scene name in project settings
• Check for whitespace/casing differences
• Run without --scene to verify project-wide execution

Timeouts with stdout capture

• Ensure your app emits readiness markers to stdout
• Increase timeout in scene capture settings
• Verify logs are not redirected away from stdout in CI

Flaky visual diffs

• Disable animations and dynamic content
• Normalize locale/timezone/font rendering
• Keep executable build and runtime environment consistent

Missing snapshots or write failures

• Confirm project file path is valid and writable
• Verify application data directory permissions
• Ensure snapshot directory exists or can be created by the process

JSON parsing issues in CI

• Use --format json exclusively for machine parsing
• Avoid mixing extra console text in pipeline parsing steps
• Archive raw JSON output as an artifact for debugging