The Specify GitHub app helps you distribute your design tokens and assets from your Specify to your GitHub repositories. Every changes detected in your Specify repository will create a Pull Request in your GitHub repository.
Please make sure you must have connected your GitHub account to Specify.
How to install the GitHub app:
Go to the applications catalog in the Destinations page
Select GitHub
Click on "Connect"
Select the repositories you want Specify to have access to
Your will now be able to connect your Specify and your GitHub repositories together 🎉
Specify has the following permissions:
Read access to your GitHub repository metadata
Read and write access to code, issues, and pull requests
How to connect your Specify and your GitHub repositories?
Once you've connected your GitHub account, Specify has to know what design tokens to synchronize and how.
Go to the Specify repository page you want to distribute design data from
Go to its "Destinations" page
Click on "Add destination"
Select "GitHub application"
Select your GitHub account
Select the GitHub repository you want to distribute design data to
Create the Pull Request containing your default configuration file
Merge the PR created by Specify containing your configuration file
Specify will now automatically sync design data to your GitHub repository 🎉
By default, Specify only returns your design data as JSON. Our newly created Pull Request contains a .specifyrc.json file doing just that from what you have in Specify. However JSON might not be what you need for your project.
Check out our templates ↗ or our guide on how to create a configuration file ↗ to create a custom configuration that suits your needs.