.. _doc_pages_project_github:

Importing from GitHub
=====================

The integration between W4 Build and Github is the most complete, since we use `Github App <https://docs.github.com/en/apps>`_.

After you have installed the W4 Build github App, you project is almost ready to be deployed. The installation include

#. Read your repository
#. Receive any action that occurred in your repository


Github Integration
----------------

Follow these steps to install the github application on W4 Build:

#. Click "Projects" under the Sources menu.

    .. image:: ../img/common/home.png
       :alt: Github Home

#. Click the connect button on the github row

    .. image:: ../img/github/row.png
       :alt: Github Home

You will be redirected to Github Application approval page.

#. Click the option "Only select repositories"

    .. image:: ../img/github/only_repos.png
       :alt: Github Home

#. Search and Select the repos that you want to grant access

    .. image:: ../img/github/access.png
       :alt: Github Home

#. Click "Install & Authorise" button

    .. image:: ../img/github/authorize.png
       :alt: Github Home

#. W4 Build will receive all the granted information from github. And the pop up will close


#. Verify that all selected repositories are listed

    .. image:: ../img/github/repo_list.png
       :alt: Github Home


That's it! Github integration is complete!!!!!

To build your project jump to `Exporting a Game <../../export_game/index.html>`_.