THE FIELD GUIDE

Using it in CI

For a custom workflow, the core capture-and-compare steps are:

yaml
- run: pip install "fxcss[images]==0.22.1"
- run: fxcss shot --theme base --out shots/base
- run: fxcss shot --theme head --out shots/head
- run: fxcss compare --base shots/base --head shots/head --out out/ --platform ${{ runner.os }}

These steps assume the two theme revisions are checked out, Firefox is installed and a display is available. Browser chrome requires a rendered window: macOS and Windows runners have a display; Linux needs Xvfb. Firefox's headless mode does not render the browser chrome.

Start with fxcss init for the complete setup. The workflow examples explain the generated files. If your project needs a visual pass/fail policy, read compare's summary.json and apply its chosen threshold.

theme previews by fxcss