test-with-meticulous
To test and debug frontend changes using Meticulous, follow the workflow below step by step, using the CLI commands as described.
Step 1 -- Trigger Meticulous test run
If you are already given a test run id, then skip this step.
- If possible, find out what build artefact Meticulous expects by checking
.github/workflows/for one of the following steps:uses: alwaysmeticulous/report-diffs-action/upload-assets@v1- build assetsuses: alwaysmeticulous/report-diffs-action/upload-container@v1- docker image
- Build the frontend.
- Upload the build artefact and trigger a Meticulous test run:
# upload-assets
npx @alwaysmeticulous/cli ci upload-assets --appDirectory <path-to-build> --repoDirectory <path-to-repo> --waitForTestRunToComplete
# upload-container
npx @alwaysmeticulous/cli ci upload-container --localImageTag <image-tag> --repoDirectory <path-to-repo> --waitForTestRunToComplete
More from alwaysmeticulous/skills
meticulous-cli
Overview of the Meticulous CLI tool and its global options. Use when asking about the meticulous CLI in general, available commands, or global flags that apply to all commands.
28meticulous-simulate-and-diff
Run a Meticulous session simulation against a live URL and analyze the visual output — either by inspecting screenshots directly (quick-check mode) or by comparing pixel and HTML diffs against a base replay. Use when checking whether a code change has introduced visual regressions for a specific session.
23meticulous-cli-schema
Meticulous CLI schema command for outputting the full CLI command structure as JSON. Use when you need to programmatically inspect available commands and their options, or when building tooling that drives the Meticulous CLI.
20meticulous-cli-download
Meticulous CLI download commands for fetching recorded sessions, replays, and test runs to the local data directory. Covers `meticulous download session`, `meticulous download replay`, and `meticulous download test-run`.
20meticulous-cli-auth
Meticulous CLI authentication commands. Use when logging in, checking who is authenticated, or logging out of the Meticulous CLI. Covers `meticulous auth whoami` and `meticulous auth logout`.
20meticulous-cli-project
Meticulous CLI project commands for inspecting the project configuration linked to an API token. Covers `meticulous project show`.
20