Install axe DevTools Cypress via Agora
Directly access Deque's artifact repository to download axe DevTools
For customers who do not have an internal artifact repository and desire a more sustainable and scalable solution for installation than directly downloading axe DevTools, Deque makes its own artifact repository available to select customers. For information on other ways to install axe DevTools, see the guides on Installing from your Artifact Repository.
In order to install axe DevTools from Agora, you must have Agora login credentials. Additionally, you must have an existing NodeJS based web project to install axe DevTools within. Depending on the configuration of your testing environment, your testing library may be required as an additional dependency.
The simplest way to access your API key is through the Agora webapp. Once logged in, you can find yor API key by clicking on the button labeled “Welcome
<your-email-address>” in the top bar next to the help button. From there you can copy your API key.
To access axe DevTools packages through NPM or Yarn, you will need to add your Agora authentication information to a ~/.npmrc file. The simplest way to do this is with a curl command.
curl -u"<your-email>":<your-api-key> "https://agora.dequecloud.com/artifactory/api/npm/auth"
When executing this command, replace $your-email with your Agora login email, and replace $your-api-key with the api key you copied in the previous step. The return of the command should look like this:
_auth =<generated-auth-string> always-auth=true email=<email@example.com>
Next, open your ~/.npmrc file for editing. Add the registry information first, then add the output from the curl command. The final product should look like this:
@axe-devtools:registry=https://agora.dequecloud.com/artifactory/api/npm/devtools-npm/ //agora.dequecloud.com/artifactory/api/npm/devtools-npm/:_auth=<generated-auth-string> //agora.dequecloud.com/artifactory/api/npm/devtools-npm/:email=<firstname.lastname@example.org> //agora.dequecloud.com/artifactory/api/npm/devtools-npm/:always-auth=true
If you are unable to execute curl commands, you can generate your auth string by base-64 encoding
<your-email>:<your-api-key> and adding the product to the ~/.npmrc file the same way as if were generated with the curl command.
To install axe DevTools Cypress in your project, run this command:
npm install @axe-devtools/cypress
If you haven’t installed Cypress itself yet, you can install it with the command
npm install cypress