You can connect your GitHub account to zeroheight. This will enable you to sync files between GitHub and zeroheight.
Learn more about related features:

• Syncing Markdown 
• Manage design tokens
• Measuring the adoption of your design system in code

When you connect your GitHub account, you can access files from any repository you can access in GitHub — including private and public repositories from the organizations you belong to.

Other users in your team can also use your integration if it is shared. Learn more about sharing git integrations

How to connect to GitHub

GitHub is connected via individual user accounts. Access is controlled via individual user profiles.

Cloud-based accounts

1. Go to 'Your Profile' and select 'Integrations' from the left-hand navigation panel

   

2. Click Connect next to GitHub
3. You will then need to pick the "GitHub.com" option and optionally uncheck Share this integration with your team if you do not wish to share it
   
4. Log into GitHub and Authorize the connection with zeroheight

Self-hosted accounts

1. Go to 'Your Profile' and select 'Integrations' from the left-hand navigation panel

   

2. Click Connect next to GitHub
   
   
3. Select "Self-hosted" from the dropdown and optionally uncheck Share this integration with your team if you do not wish to share it
4. Enter the URL of your GitHub instance and your personal access token and hit "Continue"

Creating a personal access token in GitHub (self-hosted)

1. Log in to your GitHub account and navigate to 'Settings' by clicking on your profile picture in the top-right of the screen
2. Navigate to 'Developer settings' from the left navigation panel
3. Under the heading 'Personal access tokens', select 'Tokens (classic)'
   👉 Note: Ensure you choose a 'classic' personal access token for general use and not a 'fine-grained token'
4. Generate a new personal access token with the following scopes selected:
   • repo
   • user
5. Copy the personal access token to your clipboard and return to the setup flow in zeroheight to paste this in

👉 Note: If you join a new GitHub organization after connecting your zeroheight account to GitHub, you will need to disconnect your GitHub account and reconnect, ensuring you grant access to the organization in the process.

From the Markdown block

1. In the toolbar, select Markdown block

   

2. Click on the block to import markdown
3. Select Connect GitHub

   

4. Follow the instructions from above to finish connecting to GitHub

FAQ

Who has access to a connected GitHub account?

GitHub accounts are connected at the user level. Only the user who connected their GitHub account can see the repos and the files they contain within zeroheight unless you have shared your integration. Other users within a team will only be able to see files that have been added to zeroheight somewhere.

What GitHub accounts does zeroheight support?

zeroheight supports Free, Pro, and Team GitHub accounts.

We support GitHub Enterprise Cloud and self-hosted GitHub Enterprise Server accounts.

Can I connect public and private repositories?

Yes. When you connect your account, you can access files from any repository you can access in your connected tool— this includes both private and public repositories from the organizations you belong to.

If I connect my GitHub account to zeroheight, how is it secured?

We use an OAuth GitHub app and limited scopes to enable the integration to function. We do not display the integration token on the front end.

I can't see repositories from my new organization

If you join a new GitHub organization after you have connected your zeroheight account to GitHub, you will need to disconnect your GitHub account and then reconnect, ensuring you grant access to the organization in the process.

What happens if I connect the repo and then I'm no longer part of the zeroheight account?

When you connect GitHub to your account, it's only connected to your zeroheight account. If your zeroheight account is deleted, the GitHub connection is made redundant.

Can I get a static IP address to allow through my firewall?

If you need a static IP to allow zeroheight to access your GitHub instance, e.g. through a firewall, please contact support@zeroheight.com