Sync with GitHub
Amplication can push the code of your app to a GitHub repository. It will provide you with full control over your project and will also allow you to easily track the code generated by Amplication.
Amplication Free Plan works differently from the Pro and Enterprise Plans. See: Differences between sync with a Git provider in Free edition and Pro/Enterprise Plans
Creating a new repository in GitHub
If you want to create a new repository in GitHub, you can do so here. Select Initialize this repository with a README file to make sure the new repository is not empty.
Working on Local Amplication Server
If you are hosting a local Amplication server, you should first read Connect Amplication server to GitHub to see how to configure the Server to work with a new GitHub application.
Using the Amplication hosted service
If you are using the hosted service on https://app.amplication.com, you can continue with this article.
Authorize Amplication to access your GitHub account
Before integrating your application with GitHub, you need to authorize Amplication to get access to your GitHub account.
- Open up an Amplication project.
- Click Connect to GitHub at the bottom left of your project. The Sync with GitHub screen opens.
If this is the first time that you have connected to GitHub, the Connect to GitHub button is displayed. If you have already connected to GitHub, you will be prompted to choose the installed organization. If several organizations are configured, you will be prompted to select the required organization.
Click Connect to GitHub The Install Amplication Github App opens.
Select the GitHub account you want to use.
In the new window, select on which repositories you want to install the app.
Currently, only by connecting to an organization can you create a new GitHub Repository. A User can sync only with an existing repository.
Create a new Pull Request in GitHub
- To test the process, make a change in your application and click the Commit changes & build button on the right side panel.
- To view your previous commits in Amplication, select the drop down from the top of the page, then click Commits.
- To view the new Pull Request in GitHub, select the most recent commit and click Open with GitHub, located at the bottom of the screen.
- You can now view the code changes generated by Amplication, and merge them.