Skip to content

Render A Scene

Render one registered scene with:

studio render <deck_id>/<scene_id> --profile draft

Example:

studio render examples/square_to_circle --profile draft

Before Rendering

Check the catalog and target:

studio catalog validate
studio validate examples/square_to_circle

Check render prerequisites:

studio doctor

Profiles

Use draft for fast iteration:

studio render examples/square_to_circle --profile draft

Use review when layout and pacing need review artifacts:

studio render examples/square_to_circle --profile review

Use final only for delivery-oriented output:

studio render examples/square_to_circle --profile final

Output

Every render writes an isolated build under builds/. The command prints:

  • build status
  • build ID
  • build path

Inspect the result:

studio inspect <build-id>

Scene builds include compatibility files result.json and artifacts.json, plus a canonical manifest.json with preflight issues, command context, smoke render status, logs, override flags, beat metadata, and artifact paths.

Forcing A Render

Use --force only when you intentionally want to run despite preflight issues:

studio render examples/square_to_circle --profile draft --force

Smoke render failures still block review/final rendering.