Skip to main content

tsci snapshot

tsci snapshot renders your boards to SVG images and compares them with saved snapshots.

Usage​

tsci snapshot [options]

Options​

  • -u, --update – write new snapshots to disk.
  • --3d – also generate 3D preview snapshots.

Which files are snapped?​

The command searches the current project for:

  • the detected entrypoint (using the same logic as tsci build)
  • any files matching *.board.tsx or *.circuit.tsx

This pattern allows standalone board files (ending in .circuit.tsx) to be tested alongside your main project.

Snapshot location​

Snapshots are stored next to each source file in a __snapshots__ directory. For a file test.board.tsx you will see:

__snapshots__/test.board-pcb.snap.svg
__snapshots__/test.board-schematic.snap.svg

If --3d is specified, a -3d.snap.svg is also produced.

Running without --update verifies that the generated output matches the existing snapshots. Differences cause a non-zero exit code.