Skip to main content

Documentation Index

Fetch the complete documentation index at: https://momentic.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

Golden files are the source of truth for snapshot-based steps like Visual diff. By default they’re stored on the dashboard; opt into local storage to keep them alongside your tests.

​
Enable local storage

  1. In your Visual diff step, omit the screenshot key so Momentic stores the snapshot locally: 
    - visualDiff:
    on: Order summary panel
    threshold: 0.1
  2. Snapshots are written to <momentic-root>/golden/visual-diff/<command-id>.jpg by default. The command ID is the internal identifier minted from the step’s position in the test: 
    momentic.config.yaml
golden/
  visual-diff/
    c41afa9a-....jpg
  3. (Optional) Override the directory via goldenFileDir in momentic.config.yaml:
    momentic.config.yaml
    goldenFileDir: tests/snapshots

​
Update snapshots

npx momentic run --update-golden-files
--update-golden-files makes snapshot-based tests pass even when the current state differs from the stored snapshot. Use it intentionally.

​
Colocate snapshots with tests

Point the screenshot.data field at a path relative to the Momentic root: 
- visualDiff:
    on: Upload button
    threshold: 0.4
    screenshot:
      data: momentic/tests/visual-diff/golden/upload-button.jpg
      width: 1920
      height: 1080
Resulting layout: 
momentic.config.yaml
momentic/
  tests/
    visual-diff/
      visual-diff.test.yaml
      golden/
        upload-button.jpg