Skip to main content

Level CI quick setup

Configure Level CI in an existing repository. It automates common setup steps and provides AI prompts for repository-specific changes that require an AI coding agent or manual input.

On this page:

Prerequisites

Before you configure Level CI, make sure you have:
  • Access to the connected repository.
  • A Level CI project token.
  • Permission to install project dependencies.
  • Permission to add repository secrets and update the pipeline configuration.

Initialize Level CI

From the project root, run:

npx level-ci init

The interactive setup requests your project token, retrieves project metadata, detects or confirms your end-to-end (E2E) framework, and shows the planned changes.

Quick Setup can:

  • Generate level-ci.config.ts.
  • Install the relevant E2E integration package.
  • Add level-ci-reports to .gitignore.
  • Provide the remaining setup steps.
Screenshot of the initialize Level CI setup screen displaying the setup steps to run an automated setup.

The Initialize Level CI section shows:

  • Automated setup selected.
  • The npx level-ci init command.
  • Your masked project token.

A message explaining that the command generates the configuration file, installs the E2E package, and updates .gitignore.

Generate Level CI accessibility reports

Add levelAnalyze to your E2E tests to generate Level CI accessibility reports.

Select your framework:

  • Playwright
  • Cypress
  • Puppeteer
  • WebdriverIO
  • Selenium Java
Screenshot of the generate Level CI accessibility reports screen, displaying the steps to generate reports and configure end-to-end tests.

You can use AI-assisted setup or configure your framework manually.

AI-assisted setup

Select the AI prompt tab and copy the provided prompt into your AI coding agent.

The prompt instructs the agent to:

  • Install and import the correct Level CI framework package.
  • Add or expose levelAnalyze.
  • Run the accessibility analysis after each test or specification.
  • Write reports to level-ci-reports.
  • Preserve the existing test configuration.
  • Avoid hardcoding tokens.

The Generate Level CI accessibility reports section includes:

  • AI prompt and Manual setup tabs.
  • A framework selector.
  • A framework-specific prompt.
  • A control to copy the prompt.

 

 

 

Powered by Zendesk