Your First Cypress Run
Running Cypress tests in parallel with Currents Dashboard
Setting up Currents for running and recording cypress tests in parallel can be done seamlessly within a few minutes.
Here's an overview of what steps you'll need to take to start running cypress tests in parallel using the Currents dashboard:
- Create an organization and a project
- Create a new configuration file
currents.config.js
with the newly createdprojectId
and a record key - Update
cypress.config.js
to include thecypress-cloud/plugin
plugin - Use
cypress-cloud
CLI command to create your cypress run - Update your CI provider configuration
After signing up for the dashboard service, you will be prompted to create a new organization and a project. You can change the name later.

Creating an Organization and a Project in Currents dashboard
After creating a new organization and a project, you'll see on-screen instructions with your newly created
projectId
npm install cypress cypress-cloud
Create a new configuration file and put it in your project's root folder:
// currents.config.js
module.exports = {
projectId: "Ij0RfK", // the projectId from https://app.currents.dev
recordKey: "xxx", // the record key from https://app.currents.dev
};
cypress.config.js
cypress.config.ts
cypress.json
const { defineConfig } = require('cypress')
const { cloudPlugin } = require("cypress-cloud/plugin");
module.exports = defineConfig({
// ...
e2e: {
setupNodeEvents(on, config) {
return cloudPlugin(on, config);
},
}
})
import { defineConfig } from 'cypress'
import { cloudPlugin } from 'cypress-cloud/plugin'
export default defineConfig({
// ...
e2e: {
setupNodeEvents(on, config) {
return cloudPlugin(on, config);
},
}
})
cypress-cloud
requires cypress version 10.0.0+. Please refer to our legacy integration for the setup instructions Run
currents
command to create your first cypress run in Currents dashboard.npx cypress-cloud run \
--parallel \
--record \
--key RECORD_KEY \
--ci-build-id hello-currents
Running this command will create a new run in Currents dashboard.

Creating the first cypress run with Currents dashboard
Learn more about
To unlock the full power of Currents dashboard, update your CI provider configuration to use Currents for running your cypress tests in parallel. Please read our Parallelization Guide and check out few CI Setup examples for popular CI tools.