.. _doc_pages_project_gitlab:

Importing from GitLab
=====================

Gitlab integration is composed of 2 steps:

#. Approve Oauth integration
#. Import repositories

To enable Gitlab Integration, follow these steps:

Gitlab Integration
----------------

#. Click "Projects" under the Sources menu.

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

#. Click the connect button on the Gitlab row

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

You will be redirected to GitLab Application approval page.

#. CLick Authorize Button

    .. image:: ../img/gitlab/auth.png
       :alt: Github Home

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


Importing Gitlab Repositories
-----------------------------

Once you have approved Gitlab integration

#. Click to expand the gitlab context menu

#. Click Import Repositories

    .. image:: ../img/gitlab/context.png
       :alt: Github Home

A window will be displayed

#. Search for any repository you wan tto import

    .. image:: ../img/gitlab/search.png
       :alt: Github Home

#. The repository should now be under Gitlab row

    .. image:: ../img/gitlab/new_repo.png
       :alt: Github Home

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

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


.. warning:: TROUBLESHOOTING: Sometimes Gitlab Returns an empty or not all the repositories the access token has access to, unfortunately this is a bug on their platform. If this happens, click the re-import button again.