You can connect your GitHub account to zeroheight. This will enable you to sync documentation written in markdown and stored in GitHub with your design system site. Learn more about how syncing markdown works here.

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

Connect to GitHub

From Your Profile page

1) In Your Profile under Integrations, click Connect next to GitHub  

2) Log into GitHub unless you’re already logged in  

3) Click Authorize  

4) Your Github account is integrated with zeroheight 

👉 Note: 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.

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 to connect to GitHub from Your Profile page

5) Now that you’ve connected GitHub, you’re ready to sync your first markdown file.

👉 Note: You're allowed to have a maximum of 5 connected repos with the Professional plan and 10 connected repos with the Enterprise plan.

FAQs

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. 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. At this time we support GitHub Enterprise Cloud accounts but do not support self-hosted GitHub Enterprise Server accounts.

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.

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.