Git Integrations With Fleek

Fleek allows for automatic deployment on push to your repository, and provides a variety of tools to manage your application from your preferred interface. Updates pushed to the project-linked repository are automatically deployed through Fleek, and the triggers behind this can be controlled on a granular level through Fleek platform settings.

Fleek allows for automatic deployments on every branch push and merges onto the production branch of your GitHub projects.

Using Git with Fleek offers numerous benefits which includes:

  • Automatic deployments on every branch push and merges onto the production branch of your GitHub projects.
  • The ability to manage your deployments from an interface you are already familiar with. With insights on details and deployment logs.
  • Settings for deployment like managing environment variables, custom domains, and more.

The supported provider for now is GitHub, but we are working on adding support for other Git providers in the future.

Deploying Git Repositores with Fleek

Fleek allows deployments of Git repositories from all Git providers and it is able to select specific branches (typically main) to deploy from when set up. It is an easy process to deploy repositories into production.

Once your site is deployed, Fleek offers several customization options to make your site more personal and professional. You can link a custom domain to your deployed site, providing a branded and memorable web address. Additionally, Fleek supports the integration of Ethereum Name Service (ENS) domains, allowing for a decentralized web address that aligns with the Web3 ethos. For those who prefer a simpler option, you can also edit the random name slug generated by Fleek, giving your site a more human-readable URL that’s easy to share and remember.

In essence, Fleek simplifies the deployment process while offering robust customization options, making it an excellent choice for developers looking to bring their Git-based projects into production quickly and efficiently.

How to deploy from a Git repository

  1. Go to your Fleek dashboard and click on the ‘Sites’ button at the top of the page.

sites page

  1. On the “Sites” page, click on the “Add new” button and click on “Deploy my site”. We will not be deploying a template here as it is not necessary for this guide. You should see the below after clicking the button:

Git providers

  1. Only GitHub support is available for now. We have the option to deploy with the Fleek CLI in the case of other Git providers. On this page we will be prompted to install and authorize the “Fleek CI” on GitHub since it is our first time.

install fleek app

  1. Click on the “GitHub” option in the Git providers screen and you will be redirected to GitHub to install and authorize the “Fleek CI” application.

install fleek ci

  1. As soon as we are done with the actions on GitHub, we should see the below screen and then be redirected back to Fleek.

authenticated screen

  1. We will then see a list of our repositories. We select the repository we want to deploy and then the card on our screen changes to have a “Configure Site” card appear on the screen. Relevant details about repository are displayed in fields within the card.

  2. Check that all details are correct; the “Branch”, the “Build Command” and the “Publish Directory”. You can decide to “Show advanced options” to add additional information. After which we can click on the “Deploy Site” button.

Deploy site

  1. After clicking the “Deploy Site” button, we will see a “Deploying” screen. This screen will show the progress of the deployment and the logs of the deployment. That’s it!

deploy proress

Further and additional relevant information can be found on the Deployments page.

Managing Git integrations

  1. Go to your Fleek dashboard and click on the ‘Settings’ button at the top of the page.

settings page

  1. Click on the ‘Git Integrations’ tab on the left sidebar.

git integrations page

  1. Click on the “Install App” buttons. You will be redirected to Github to install and authorize the Fleek applications.

install app

  1. After authorizing the Fleek application, you will be redirected back to Fleek. The “Install App” button will now be replaced with an “Active” button.

active states

That’s it! You have successfully set up Git Integrations with Fleek. You can now manage your deployments from your Github repository within Fleek!

Removing Git integrations

From GitHub

You may want to remove the Git integrations from your Fleek account. To do this, Go to your Github profile settings and click on the ‘Applications’ tab on the left sidebar, you will see a list with all your installed Github applications.

You can click to go to any of the Fleek applications (“Fleek Templates DEV” or “Fleek CI DEV”) and click on the “Uninstall” button to remove the Fleek application.

Uninstall app