Discuss

Connecting to GitHub, Gitlab or BitBucket

On this page

With Wappler you can connect seamlessly your Wappler project to Github, Gitlab or BitBucket repositories. You can push and pull your local project to the selected remote repository.

Creating a local repository

First you need to setup a local repository. This is quite an easy task, just open the Git Manager Panel:

Screenshot_1|690x414

And click the Create Repository button:

Screenshot_2|690x414

Select the uncommitted changes and commit them:

Screenshot_3|690x414

We are done setting up the local repository, so let's setup a remote one.

Creating a remote repository

You can connect to Github, GitLab and BitBucket repositories directly from Wappler, as Wappler is now an officially registered app for these 3 providers!

In our example we will show you how to create and connect to a Github repository, the process is the same for the other two providers.

First go to https://github.com/ and log in. Then click the New button in the Repositories section:

Screenshot_5|690x414

Add a name for your repository:

Screenshot_6|690x414

Select whether this repository should be a public or a private one:

Screenshot_7|690x414

It is important not to select anything under Initialize this repository with. Simply skip this step:

Screenshot_8|690x414

And click the Create repository button:

Screenshot_9|690x414

Copy your repository address, as you will need it in the next steps:

Screenshot_10|690x414

Working with remote repositories

Switch back to Wappler.

Connecting to a remote repository

Click the Connect to remote repository button, located in the Git Manager:

Screenshot_11|690x414

Paste your remote repository address:

Screenshot_12|690x414

Then add a name for this repository. This name is used in Wappler UI so that you know which remote repository is selected. It can be any random name. Click Connect:

Screenshot_13|690x414

Authorizing Wappler access

An authorize dialog will appear. You need to authorize GitHub Access for Wappler. There are two options available - authorize Wappler for just the current Github/Gitlab/Bitbucket repository and/or store the authorization globally for all your Wappler projects. We select both, so that we don't have to do this for each of our projects:

Screenshot_16|690x414

Click the Authorize button:

Screenshot_17|690x414

You will be taken to the app authorization page in your browser. Click the Authorize Wappler button:

Screenshot_18|690x414

And click the Open Wappler button in the alert which appears:

Screenshot_19|690x414

You will be taken back to Wappler, where you can see the remote repository in the dropdown:

Screenshot_14|690x414

Pushing content to the remote repository

In order to upload local repository content to a remote repository, we use the Push option. Pushing is how you transfer commits from your local repository to a remote repository. Click the Push to Remote button in order to do this:

Screenshot_15|690x414

And you are done! Your local repository content is now transferred to your remote repository. We can see this in GitHub:

Screenshot_20|690x414

Controlling Wappler Git Account Authorizations in Global options

You can control the Git Account Authorizations for Wappler in the global options. There you can set up them globally so you don't have to authorize Wappler every time for each of your projects.

Click the Options button:

Screenshot_2|690x414

Select Git and you will see the connect options for Github, Gitlab and BitBucket. Here you can enable or disable global authorization for Wappler:

Screenshot_3|690x414

Enabling each of them will take you to the App Authorization pages of each of the providers. Follow the instructions in your browser to authorize Wappler.