Skip to main content

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.

note

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.

  1. Open up an Amplication project.
  2. 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.

  1. Click Connect to GitHub The Install Amplication Github App opens.

  2. Select the GitHub account you want to use.

  3. In the new window, select on which repositories you want to install the app.

note

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​

  1. To test the process, make a change in your application and click the Commit changes & build button on the right side panel. Amplication service dashboard with "Commit changes & build" button outlined.
  2. To view your previous commits in Amplication, select the drop down from the top of the page, then click Commits. Amplication service dashboard with "Commits" button outlined.
  3. 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.
  4. You can now view the code changes generated by Amplication, and merge them.