Skipper

Getting Started

Up and running in 4 steps.

1. 1

   Set up the Google Spreadsheet

   Create a new Google Spreadsheet and add three columns: testId, disabledUntil, and notes. Then create a Google Service Account, download its JSON credentials file, and share the spreadsheet with the service account email address.

   You can start from the ready-made template — just make a copy and use it as your own: Open the template spreadsheet →

2. 2

   Install the package

   JS / TS PHP Go .NET Java

   Install the adapter for your test runner:

   Jest

   npm install @get-skipper/jest

   Vitest

   npm install @get-skipper/vitest

   Playwright

   npm install @get-skipper/playwright

   Cypress

   npm install @get-skipper/cypress

   Nightwatch

   npm install @get-skipper/nightwatch

   composer require get-skipper/skipper-php

   Install the adapter for your test runner:

   testing

   go get github.com/get-skipper/skipper-go/testing

   Testify

   go get github.com/get-skipper/skipper-go/testify

   Ginkgo

   go get github.com/get-skipper/skipper-go/ginkgo

   Install the adapter for your test runner:

   xUnit

   dotnet add package GetSkipper.XUnit

   NUnit

   dotnet add package GetSkipper.NUnit

   MSTest

   dotnet add package GetSkipper.MSTest

   Playwright

   dotnet add package GetSkipper.Playwright

   SpecFlow

   dotnet add package GetSkipper.SpecFlow

   Add the dependency for your test runner to pom.xml:

   JUnit 5

   <dependency>
     <groupId>io.getskipper</groupId>
     <artifactId>skipper-junit5</artifactId>
     <version>1.0.0</version>
     <scope>test</scope>
   </dependency>

   TestNG

   <dependency>
     <groupId>io.getskipper</groupId>
     <artifactId>skipper-testng</artifactId>
     <version>1.0.0</version>
     <scope>test</scope>
   </dependency>

   Cucumber

   <dependency>
     <groupId>io.getskipper</groupId>
     <artifactId>skipper-cucumber</artifactId>
     <version>1.0.0</version>
     <scope>test</scope>
   </dependency>

   Playwright

   <dependency>
     <groupId>io.getskipper</groupId>
     <artifactId>skipper-playwright</artifactId>
     <version>1.0.0</version>
     <scope>test</scope>
   </dependency>

3. 3

   Set the environment variables

   Skipper reads its configuration from two environment variables:

   SKIPPER_SPREADSHEET_ID The ID from your spreadsheet URL

   GOOGLE_CREDS_B64 Your service account JSON key, base64-encoded
4. 4

   Connect Skipper to your test runner

   Each integration hooks into your framework's native setup mechanism — no changes to individual test files required. See the setup guide for your framework in the corresponding GitHub repository.