Skip to main content

Managing your app

This page explains the concepts of workspaces and apps, shows their location in the interface and explains what can be configured.

App store​

Apps can be found in the app store page of the environment. All users (except for external users/developers) have access to this page, allowing easy discovery and seeing what's available.

On the details page of the app the user can find images, a description and more information about the app.

overview of apps

Creating a new app​

Apps can be created by administrators and developers. Developers are automatically assigned as the first maintainer on the app they create. In the "App Store" menu, click on the "Create app" button in the top-right corner to create a new app. You can choose between:

  • App Builder — build directly in your browser with AI assistance. See the App Builder guide.
  • Create a blank app — a temporary placeholder that shows the CLI instructions for setting up an app locally. This option will be removed in the future; local development will happen entirely through the VIKTOR CLI.

Editing an existing app​

The details of an existing app can be updated by navigating to the "App Store" menu, followed by clicking on the "Manage" button on the app card. On the details page, click the button "Edit App" in the top-right corner to go through the same steps as when you first created the app.

Version history​

All the versions of the app can be seen on a separate tab, accompanied by the publication date and developer that published this version:

app versions page

Environment variables​

ADMIN & MAINTAINERS ONLY

Administrators and app maintainers can access the variables tab on the app. On this tab, environment variables can be created, adjusted, or deleted. For more information please refer to using environment variables.

app variables page

Apps archive​

ADMIN & MAINTAINERS ONLY

To archive apps that are no longer being used, administrators and app maintainers can click the three dots on the app card and then select the "Archive" option from the menu that appears. Archived apps can be inspected by clicking the "Archive" button in the top-right corner in the "App Store" menu. Apps can be unarchived by clicking the "Unarchive" button.

Note that an app cannot be archived when:

Note that an app cannot be unarchived when:

Labels​

An admin can add labels to workspaces and apps. This enables users to filter and quickly find the tools relevant for them. For instance the labels can be used to distinguish between industry disciplines, such that a newly registered GIS user can quickly find the relevant workspaces for him/her. Besides filtering on labels, a user can also filter on workspace visibility and app name.

workspaces with GIS label

Labels on apps​

Besides labels on workspaces, labels can also be added to apps. These labels are pre-selected when a new workspace is created from this app. Besides filtering on these labels, users can also filter on the maintainer(s) of the app.

Label admin​

Admins can manage the labels by visiting a dedicated page in the interface. The environment will be filled with a starting list. In the enterprise tier these labels can be edited, removed and new labels can be created.

managing labels page

Label inspiration​

In the enterprise tier, labels can freely be generated and changed to meet specific needs of your company. To give some inspiration on potential use cases:

  • industry (in the starting list)
  • discipline (in the starting list)
  • integration/software package (in the starting list)
  • project name (on workspace)
  • development status (on app)