Skip to main content

Repo Url Picker

Overview​

This picker lets the user decide the target repository where the scaffolded component will be stored. witboost will create the repository according to the coordinates provided by the user, usually a namespace and a repository name.

Configuration​

RepoUrl picker fields can be customized to provide meaningful titles and helper texts that matter to your organization and way of working.

According to the Git provider configured for being used in witboost you can have a different set of fields for the RepoUrl picker. These are all the configurable fields according to your Git provider:

  • allowedOwnersLabel [string]: The allowed owners' field label, that is displayed on top of the input field.
  • ownerInputLabel [string]: The owner field label, that is displayed on top of the input field.
  • ownerInputHelper [string]: The owner field helper text, that is displayed below the input field as an informative text.
  • repositoryNameTitle [string]: The repository name field title, that is displayed on top of the input field.
  • repositoryNameDescription [string]: The repository name field's description, that is displayed below the input field as an informative text.
  • workspaceInputLabel [string]: The workspace field label, that is displayed on top of the input field. Available for the Bitbucket provider only.
  • workspaceInputHelper [string]: The workspace field helper text, that is displayed below the input field as an informative text. Available for the Bitbucket provider only.

In addition to those, you can also add whitelists for different parameters in the ui:options section:

  • allowedHosts [array<string>]: list of allowed hosts. Repositories from other hosts will not be allowed;
  • allowedOrganizations [array<string>]: list of allowed organizations;
  • allowedOwners [array<string>]: list of allowed owners;
  • allowedRepos [array<string>]: list of allowed repositories names;

E.g. for Azure DevOps you can specify the following configuration:

repoUrl:
  title: Repository Location
  type: string
  ui:field: RepoUrlPicker
  ui:options:
    allowedOwners:
      - <optional list of allowed owners (projects)>
    allowedOrganizations:
      - <optional list of allowed organizations>
    allowedHosts:
      - <your azure host address>
    allowedRepos:
      - <optional list of allowed repository names>