Skip to main content

Use Argos with Semaphore CI

Configure Semaphore CI to send screenshots to Argos visual testing platform. CI

1. Install Argos CLI​

npm i --save-dev @argos-ci/cli

Read the CLI documentation if you need information about advanced usages.

2. Expose ARGOS_TOKEN as environment variable​

  1. Log in to Argos, navigate to your repository settings and copy your ARGOS_TOKEN.
  2. In your Semaphore CI project go to Settings -> Environment Variables.
  3. Add a new environment variable called ARGOS_TOKEN and paste the value you copied in the previous step.

If you are not comfortable with exposing environment variables, read Semaphore CI documentation.

3. Upload the screenshots​

Add the following command to your CI workflow to upload screenshots to Argos:

npx @argos-ci/cli upload ./screenshots

Complete example​

.semaphore/semaphore.yml
blocks:
  jobs:
    # 👉 Insert the steps required to take screenshots

    - name: Upload screenshots to argos-ci.com
      commands:
        # 👇 change "./screenshots" by your screenshots folder path
        - npx @argos-ci/cli upload ./screenshots

What's next?

Congratulations on installing Argos! 🎉
The next step is to integrate visual review into your development workflow. Visit our review changes section to learn how to.