Github

Connect a GitHub repository

If your code is hosted on GitHub, you can connect repositories to Level CI to automatically run accessibility scans as part of your development workflow.

1. Start from the dashboard

1. In the Level CI dashboard, select the + button in the top-right corner.

   

   a. Select Import from GitHub.

2. This opens the Import Project from GitHub page.

   

2. Authenticate your GitHub organization

1. Click Connect GitHub Organization.

2. You’ll be redirected to GitHub to sign in and authorize the Level CI GitHub App.

3. Permissions requested

To enable automated scanning, Level CI requests the following GitHub permissions:

• Read account information: Identify your GitHub user/org.
• Read repositories and pull requests: Access code and PR metadata for scans and annotations.
• Read team membership: Align projects with the right teams.

When authorizing, you can:

• Grant access to all repositories.
• Select specific repositories.

These permissions can be adjusted later in your GitHub account settings.

4. Project Structure Mapping

Level CI mirrors your GitHub hierarchy:

• One Level CI project ↔ One GitHub repository
• Repositories remain organized under their GitHub organization or personal account.
• A single Level CI organization can be connected to multiple GitHub organizations or accounts.

5. Import Projects

After authorization:

• Level CI displays a list of available repositories.
• Select the repositories you want to import.
• Optionally override default settings (project name, main branch).
• Click Create Project.

⚠️ Note: A GitHub repository can only be imported once into Level CI.

6. Configure Your Project

Once imported, you’ll be prompted to set up:

• An end-to-end testing framework (Cypress, Playwright, Selenium).
• A CI/CD build environment (GitHub Actions, GitLab CI, Jenkins).

Follow the guided instructions to complete configuration.

7. Run Your First Analysis

When setup is complete, Level CI will:

• Run your first accessibility scan automatically.
• Display results in the Level CI dashboard.
• Annotate your GitHub pull requests with accessibility findings, enabling developers to act before code is merged.