1.. _`GPLv3`: http://www.gnu.org/licenses/gpl-3.0.html
2
3###############################
4Creating and Importing Projects
5###############################
6
7Builder supports creating new projects and importing existing projects.
8When importing a project, you can either open it from your local computer or
9clone it from a remote git repository.
10
11Creating a new Project
12======================
13
14To create a new project, select "New" from the project greeter.
15The project creation guide will be displayed.
16
17.. image:: ../figures/start-new-project.png
18   :width: 512 px
19   :align: center
20
21Give your project a meaningful name, as this is not easily changeable later.
22The project name should not include spaces and if the project needs
23multiple words, use a hyphen "-" to separate the words.
24
25Choose the language you would like to use for the project.
26Depending on the language, different templates are available.
27
28Choosing a license helps promote sharing of your application.
29Builder is licensed as **GPLv3 or newer** and we suggest using `GPLv3`_ when
30writing new applications for GNOME.
31
32If you do not want git-based version control, turn off the switch to disable
33git support.
34
35Lastly, select a suitable template for your application.
36Some patterns are available to speed up the bootstrapping of your project.
37
38
39Cloning an Existing Project
40===========================
41
42To clone an existing project, you will need the URL of your **git repository**.
43For example, to clone the Builder project, you could specify: ``https://gitlab.gnome.org/GNOME/gnome-builder.git``.
44
45.. image:: ../figures/clone.png
46   :align: center
47
48After entering the URL, press the "Clone" button and wait for the operation to complete.
49You'll be provided progress updates during the operation.
50Once the project has been cloned, a new workspace window will be opened for the project.
51
52.. note:: If the remote repository requires authorization a dialog will be displayed for you to input your credentials.
53