Skip to main content

Managing your app

This page explains how you manage the apps you maintain: where to find them in the interface and what can be configured.

Library​

Apps can be found in the Library 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

Managing your apps from the Develop page​

The Library is meant for discovery: it shows users which apps are available and what they do. You manage the apps you maintain from the "Develop" page instead. The sections below describe the actions available there.

ADMINISTRATORS

Administrators manage all apps in the organization, including apps they do not maintain, from the "All apps" page in the Administrator panel. See All apps.

Creating a new app​

Apps can be created by administrators and developers, and only from the "Develop" page. Developers are automatically assigned as the first maintainer on the app they create. In the "Develop" menu, click on the "Create app" button 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 "Develop" menu, followed by clicking on the "Details" button on the app card. On the details page, click on the three dots in the top-right corner, and select "Edit app" 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 of the app details page, 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

Apps that are no longer being used can be archived from the "Develop" page, in either of these two ways:

  • Click the Details button on the app to open its Details page, then click the three dots in the top-right corner of the screen and select the Archive option.
  • Click the Select button on the Develop page, select the app you want to archive, and archive it from there.

Archived apps can be inspected by clicking the "Archive" button in the top-right corner of the page. Apps can be unarchived by clicking the Unarchive button.

Note that an app cannot be archived when:

  • the app has active app instances associated to it

    Solution: archive the active app instances first

Note that an app cannot be unarchived when:

Labels​

An admin can add labels to apps and their instances. This enables users to filter and quickly find the tools relevant for them. For example, the labels can be used to distinguish between industry disciplines, such that a newly registered GIS user can quickly find the relevant app instances for the user. Besides filtering on labels, a user can also filter on visibility and app name. The labels on your app are also pre-selected when a new app instance is created from it.

Adding labels is part of editing the app details, described in Add a label to an app. The labels you can choose from are managed by an administrator, see Labels.