Create a Project

   MaestroThe UI design product.  |   Form Builder |   17.10 This feature was updated in 17.10.

Journey Maestro allows you to create projects within a organization so you can build a complex structure to manage application forms efficiently.

To create a project:

1. Open a project in the Navigator pane and select an organization, where you want to create a new project.
2. Click Create Project.

   

3. Enter a project's name in the Name field, which should be unique across the organization. We recommend naming a form project based on the type of forms being produced. For example, Commercial Loans.
4. Select a project type from the Type dropdown list, which can be one of the following:  |  17.10 This feature was introduced in 17.10.
   • Standard - a source code of the project is managed by Maestro
   • SCM - a source code of the project is managed externally using various SCM, such as GitGit is a version control system for tracking changes in computer files and coordinating work on those files among multiple people. It is primarily used for source code management in software development,[8] but it can be used to keep track of changes in any set of files.. Use this project type if collaborative work on a project is required.
     Note

     The SCM project type doesn't have any impact on the content of forms. It only affects the versioning options shown in the Management Dashboard.

     Note

     If you are a Form Builder, you need to have the SCM permissions assigned to you.

   • SCM Private - same as SCM but only project owners and Maestro administrators have access to projects of this type.
     Note

     This type is available only when the project is created with the scm project add command.

5. Provide a release version in the Release Version field. By default, the release version is automatically set to the latest minor release of Maestro, but you can select an earlier release version if required.
6. Enter an initial default version and its suffix in the Initial Default Version field, which is used as the initial version for all assets created within this project. If you enter incorrect version value, the Create button will be disabled. This field is optional. For more information, see semantic versioning and tagging.
7. Provide an initial default library version value in the Initial Default Library Version field. When you create a project, the default project library is set up as well. The initial default library version define a version number for all new libraries. This makes it easier to roll back to the previous library version or set up and make changes to the new versions without affecting an organization and projects using older versions.
8. Type a meaningful description for the project in the Description field.
9. Click Create.

The new project will appear under the selected organization and will include default forms, components, and libraries, with the initial library version as you have selected above, in this example, 1.0.0.

Next, learn how to upgrade a project.