Skip to main content

Integrate GitHub with Your Project (Enterprise Only)

The GitHub integration in A11yNow allows you to connect accessibility workflows directly with GitHub repositories. Once configured, A11yNow can automatically create and synchronize GitHub issues, helping development teams track, prioritize, and resolve accessibility findings within their existing development workflow. By configuring repository settings, synchronization options, status mapping, parent linking, and field mapping, you can ensure accessibility issues remain aligned between A11yNow and your GitHub repository.

Pre-requisites​

Before configuring a project-level integration, ensure that GitHub has already been connected to A11yNow through the organization settings.

Connect GitHub to a Project​

To connect GitHub on A11yInspect with your project:

  1. Sign in to BarrierBreak A11yNow.
  2. Go to Projects module.
  3. Open the project you want to configure.
  4. Go to Integrations tab.
  5. Select Connect option under GitHub. You will now redirect to configure the required integration settings.

Configure GitHub Integration Setting​

After connecting the GitHub, configure the required integration settings by proceeding with following steps:

Step 1: Select a Repository​

Under the details, select a Repository from the dropdown list. The selected repository will be used for creating and managing GitHub issues exported from the A11yNow projects.

Step 2: Configure Sinc Options​

Choose any option to sync BarrierBreak A11yNow with GitHub. Refer the following table to understand the options:

  • Auto Sync: Automatically synchronizes updates between A11yNow and GitHub Issues.
  • Auto-create Issues: Automatically creates GitHub Issues for newly identified accessibility findings.

Step 3: Configure Parent Linking​

Choose any option to configure the parent linking as follows:

  • No Parent: The issues will be created in GitHub without parent issues.
  • Choose During Sync: It will allow you to select the parent issue while manually syncing to GitHub.
  • Default Parent: Select a parent issue from dropdown field. All the issues will sync under that selected parent issue.

Step 4: Configure Status Mapping​

Map A11yInspect issue status with the corresponding GitHub issue statuses as follows:

A11yNow Issue StatusGitHub Issue Status
To DoOpen
In ProgressOpen
DoneClose

Step 5: Field Mapping​

Map accessibility finding details to GitHub issue fields to ensure all relevant information is synced correctly during issue creation. Field mappings can be customized based on your repository requirements. Refer to the table below to fields values:

A11yNow FieldsGitHub Fields (Default)
IssueTitle
TypeLabels
SeverityLabels
Success CriteriaDescription
Conformance LevelDescription
ElementDescription
AttributeDescription
Actual ResultDescription
Expected ResultDescription
RecommendationDescription
Step To ValidateDescription
Existing CodeDescription

Step 6: Save the Configurations​

  1. Review all the configured settings
  2. Select Submit to save the configuration. All the configured integration details will be displayed on the project integration dashboard. You can edit configurations anytime.

Edit the Existing GitHub Integration Settings​

Based on your requirements, you can edit configurations anytime.

To edit the integration settings:

  1. Sign in to BarrierBreak A11yNow.
  2. Go to Projects.
  3. Open the project you want to edit.
  4. Go to Integration tab.
  5. Select View Integration option under GitHub.
  6. Select on Edit in the upper- right corner.
  7. Update the required configuration options.
  8. Select on Submit to save changes.

Disconnect GitHub Integrations​

To disconnect GitHub integration:

  1. Go to BarrierBreak A11yNow.
  2. Go to Projects.
  3. Open the project you want to edit.
  4. Go to Integration tab.
  5. Select View Integration option under GitHub.
  6. Select Unlink GitHub.

Now your GitHub is unlinked with BarrierBreak A11yNow.

note

  • You must connect GitHub in Settings before it can be linked to individual projects.