Repositories and projects

Repositories is the Home section of the application, containing a list of existing repositories and projects. Here, you can create repositories and projects, select the project you wish to work on and switch to working on it. In the Version tab, you can view all changes previously made and committed to the project. The Project access tab allows to manage access for other users, enabling them to view or edit projects.

After successful authorization in the system, the Home application will open.

How to Navigate Project Settings Information

To go to the Repositories section, select the Repositories tab on the left horizontal panel to view the list of repositories and projects.

Select the project you need from the list. The project can be managed by three tabs, placed below the projects list.

  1. The General tab has a button allowing you to start, and resume work on the project.

It contains general project data:

  • Project name.

  • Short ID — a unique identifier for the project.

  • Create time — the time of the project creation.

  • Commits count — number of commits within the project.

  • Last commit time.

  • Last commit by — the email of the user who made the last change to the project.

  1. Versions. Allows you to view the revision history or information about the project.

It presents the following information:

  • Branches — the list of all branches created during commits.

  • Graph — the list of created branches and their commits presented in a graphical format.

  • Commits — the list of all created commits within the project. Each commit includes information about its ID and branch, date of creation, author, and comment.

  • Tags — the list of all created project tags in alphabetical order.

  • Changes — the list of all changes between the current and the previously made commit. To view this difference between old and new versions, select the desired entity. All changes are indicated in colors: green — added data; red — deleted data; blue — changed data.

  1. Project access. This section allows you to view the list of users with project access. For how to manage users' access, see the How to Assign a Viewer or Editor Role to a User section.

How to manage Repositories and Projects

Repositories

A repository is a storage unit where you can store your projects. Repositories enable you to organize your projects according to specific requirements and topics.

Select the repository you wish to work on. The information about the repository and the projects contained can be viewed to the right of the repository list.

You can create repositories by the following steps:

  • Click + New Repository button.

  • Enter the required information in the pop-up window: Name, Repository ID, and Description (optional).

The Repository name should be more than 3 characters and less than 64 and can include letters (Latin a-z, A-Z), numbers (0-9), $, and an underscore.

The Repository ID should be more than 3 characters and can include letters (Latin a-z, A-Z), numbers (0-9), $, and an underscore. It should begin with a letter.

The Repository ID should be unique within the system.

  • Click the CREATE button.

Projects

To create a project, сlick the New Project button.

  1. Select the repository.

  2. Fill in the project name and ID, description (optional) in the pop-up window.

  3. Check out the suggested project templates. You can create a template project or an empty project according to your logic. Template projects are also available from the IDE Menu (Help)

  4. Click the CREATE button to complete the creation.

The Repository name should be more than 3 characters and less than 64 and can include letters (Latin a-z, A-Z), numbers (0-9), $, and an underscore.

The Repository ID should be more than 3 characters and can include letters (Latin a-z, A-Z), numbers (0-9), $, and an underscore. It should begin with a letter.

Enter a new project name in the pop-up input field, then click the RENAME button. The project name will be changed to a new one.

Confirm the action by pressing the DELETE button.

  1. Select the repository.

  2. Fill in the project name and ID, description (optional) in the pop-up window.

  3. Click the CLONE button to complete the operation.

How to work with the Versions tab

To start working on a specific version, select the required version, then press the WORK button. To view the desired version of the project, select it, then click the VIEW button. When selecting the View option, the project can only be viewed and not edited.

How to Assign a Viewer or Editor Role to a User

Access to the project can be provided and managed both for individual users and groups in the Project access tab. To go to the Project access tab, click the relevant project, and then activate the Project access tab.

  • To grant access to a group of users to the project, click the Add group button in the right part of the General tab.

  • Select a group you wish to add.

  • Assign the "Editor" or "Viewer" role as needed. The "Viewer" role provides view-only access to the projects. This access level is ideal for users who only need to review project content without making any modifications. The "Editor" role is suitable for users who need to edit the project. To learn more about the available roles and their features, please refer to the User Roles guide.

  • Check the group list of users to which you provide access. The list can be managed on the Organization setting page.

First, you need to add a user to the Organization Team. Then, you can assign them roles such as editor or viewer.

The user must be active on the platform. The user becomes active after accepting the invitation

  • To provide access to a user to the project, cliсk the Add user button in the left part of the General tab. Select the user’s email in the opened pop-up and apply the editor or the viewer role in the pop-up dropdown.

Last updated