Connect to a GitHub Repository (Advanced Connect)

Filter by IDE
Select the Progress AppBuilder client you are currently using for development.

IDE

This article is applicable to the in-browser client, the universal desktop client and the classic Windows desktop client. For information about version control in the extension for Visual Studio, see Use version control in Visual Studio.

You can sign into your GitHub account and connect to any of the associated existing repositories or create a new repository for your app.

Do not set one repository for multiple apps.

To develop an app in collaboration with the other account members of your Telerik Platform account, you need to use GitHub third-party version control and configure the app for collaboration. For more information, see Configure Your App for Collaboration.

Prerequisites

  • Verify that your preferred AppBuilder client is running and you are logged in.
  • Verify that you have opened the code for your app.

Procedure

In-Browser

Connect and Push to the Repository

Complete the following steps to connect to a remote repository and commit and push your code and resources to the repository.

  1. In the top menu bar, click Version ControlConfigure Remote Repository.
  2. Select Connect to GitHub and click Next.
  3. Provide your login credentials for GitHub and click Sign In.
    You can select the Remember credentials for the current browser session check box to preserve your GitHub credentials during the current browser session.

    Two-factor authentication: If you have enabled two-factor authentication for GitHub, you need to provide a personal access token instead of password.

  4. (Optional) Create a new repository.

    1. Select account context.
    2. Enter a repository name.
    3. (Optional) Enter a description for your repository.
    4. (Optional) Select the Private text box to create a private repository.
    5. Click Create.


    The in-browser client lists your newly created repository in the collection of existing repositories. To connect to the newly created repository, you need to select it from the list of existing repositories.

  5. Select the repository to which you want to connect and click Connect.
  6. (Optional) Invite collaborators.

    1. Enter the user name of the user that you want to invite.
    2. From the drop-down list, select the user that matches your search.
    3. Click Invite.


    Because of GitHub limitations, the in-browser client might not refresh the list of collaborators immediately.

  7. Verify that the check box to automatically push the app to the remote repository is selected.
    If you deselect the check box, you need to manually push the app to the remote repository later.
  8. Click Done.
  9. (Optional) Get the remote repository URL and share it with your collaborators.
    1. In the top menu bar, click Version ControlConfigure Remote Repository.
    2. In Connect to any Git provider, click the copy button for the clone URL.
    3. Share the copied URL with your collaborators.

Connect and Get Code and Resources from the Repository

Complete the following steps to override the code and resources of an app with the contents of a remote repository. This way, you can preserve your data, other services and settings enabled for your app.

  1. Select Connect to GitHub and click Next.
  2. Provide your login credentials for GitHub, choose whether you want the in-browser client to remember your credentials and click Ok.
    If you choose to preserve your login credentials, the in-browser client stores them for the current browser session only.

    Two-factor authentication: If you have enabled two-factor authentication for GitHub, you need to provide a personal access token instead of password.

  3. Select the repository to which you want to connect and click Connect.
  4. Select the Replace this app with the contents of the remote repository check box.
  5. Click Done.
  6. Confirm the operation.

Universal

  1. In the top menu bar, click Version ControlConfigure Remote Repository.
  2. Select Connect to GitHub and click Next.
  3. Provide your login credentials for GitHub and click Sign In.
    You can select the Remember credentials for the current session check box to preserve your GitHub credentials during the current session.

    Two-factor authentication: If you have enabled two-factor authentication for GitHub, you need to provide a personal access token instead of password.

  4. (Optional) Create a new repository.

    1. Select account context.
    2. Enter a repository name.
    3. (Optional) Enter a description for your repository.
    4. (Optional) Select the Private text box to create a private repository.
    5. Click Create.


    The universal desktop client lists your newly created repository in the collection of existing repositories. To connect to the newly created repository, you need to select it from the list of existing repositories.

  5. Select the repository to which you want to connect and click Connect.
  6. (Optional) Invite collaborators.

    1. Enter the user name of the user that you want to invite.
    2. From the drop-down list, select the user that matches your search.
    3. Click Invite.


    Because of GitHub limitations, the universal desktop client might not refresh the list of collaborators immediately.

  7. Verify that the check box to automatically push the app to the remote repository is selected.
    If you deselect the check box, you need to manually push the app to the remote repository later.
  8. Click Done.
  9. (Optional) Get the remote repository URL and share it with your collaborators.
    1. In the top menu bar, click Version ControlConfigure Remote Repository.
    2. In Connect to any Git provider, click the copy button for the clone URL.
    3. Share the copied URL with your collaborators.

Windows

  1. In the top menu bar, click Version ControlConfigure Remote Repository.
  2. Select Connect to GitHub and click Configure.
  3. In the pop-up window, provide your login credentials for GitHub and click Ok.
    You can select the Remember my credentials check box to preserve your GitHub credentials in Windows Vault. If selected, the classic Windows desktop client will not prompt you to provide your login credentials again.

    Two-factor authentication: If you have enabled two-factor authentication for GitHub, you need to provide a personal access token instead of password.

  4. (Optional) Create a new repository.

    1. Select account context.
    2. Enter a repository name.
    3. (Optional) Enter a description for your repository.
    4. (Optional) Select the Private text box to create a private repository.
    5. Click Create.


    The classic Windows desktop client lists your newly created repository in the collection of existing repositories. To connect to the newly created repository, you need to select it from the list of existing repositories.

  5. Select the repository to which you want to connect and click Connect.
  6. (Optional) Invite collaborators.

    1. Enter the user name of the user that you want to invite.
    2. In the dynamically generated list, double-click the user that you want to invite.


    Because of GitHub limitations, the classic Windows desktop client might not refresh the list of collaborators immediately.

  7. Verify that the check box to automatically push the app to the remote repository is selected.
    If you deselect the check box, you need to manually push the app to the remote repository later.
  8. Click Done.

Visual Studio

For information about version control in the extension for Visual Studio, see Use version control in Visual Studio.

CLI

This operation is applicable to the classic Windows desktop client and the in-browser client. With the command-line interface, you can use your preferred version control provider and tools.

Next Steps

Push your app to the repository.

See Also

Start a free trial Request a demo
Contact us: +1-888-365-2779
sales@telerik.com
Copyright © 2016-2017, Progress Software Corporation and/or its subsidiaries or affiliates. All rights reserved.