Skip to content

Creating an App

Overview

New Bellini applications are created using the Create App wizard. The wizard walks you through naming your app and optionally configuring source control and a starting template. Once created, the app is immediately available in the Apps view.

Opening the Create App Wizard

There are two ways to open the wizard:

  • Click the + button in the Apps view toolbar, then select App from the context menu.
  • Right-click the blank area in the Apps view, then select New > App from the context menu.

Step 1: App Details

The first page of the wizard has the following fields:

  • Name (required) — the name of the application. Must be unique within the organization and may only contain alphanumeric characters, hyphens (-), and underscores (_).
  • Enable Source Control — check this to link the application to a remote Git repository. Enabling this adds a source control configuration step to the wizard.
  • From Template — check this to create the application from a Lonti Marketplace template. Enabling this adds a template selection step to the wizard.

If neither option is enabled and a valid name is provided, the Create button becomes active and you can create the app immediately. If one or both options are enabled, click Next to proceed to the additional steps.

Step 2 (Optional): Source Control

If Enable Source Control is checked, clicking Next from the App Details page takes you through two source control pages.

Connect a Git Provider

Select your Git provider by clicking one of:

  • Continue with GitHub
  • Continue with GitLab
  • Continue with Bitbucket

You will be prompted to log in with the selected provider and authorize Bellini to access your repositories.

Configure the Repository

After connecting, configure the repository that will be created for this application:

Field Required Description
Account — The connected Git account (read-only, shown for reference)
Repository Yes Name of the remote repository to create
Description No Optional description for the repository
Private — Check to make the repository private
Branch No Main branch name; uses the Git provider's default if left empty

When the app is created, Bellini creates the remote repository and links it to the application automatically.

Step 2 (Optional): Template Selection

If From Template is checked, clicking Next from the App Details page (or from the source control pages if both options are enabled) shows a list of available templates from the Lonti Marketplace. Use the search bar to filter templates.

  • Click a template to select it.
  • Hover over a template and click View Template to preview it in a new browser tab.
  • Some templates require additional configuration (such as API credentials). If so, an extra step appears before the Create button becomes active.

Creating the App

Click Create to create the application. Bellini creates the app, selects it in the Apps view, and opens it in the app editor.

The Create button is disabled until all required fields are filled in. The Previous, Next, and Cancel buttons are available throughout the wizard to navigate between steps or cancel without creating.

Deleting an App

To delete an application:

  1. Right-click the app in the Apps view and select Delete, or select the app and click the Delete button in the Apps view toolbar.
  2. A confirmation modal appears. Type the app name in the confirmation field to enable the Delete button.
  3. Click Delete to permanently remove the application.

Deleting an application is irreversible. Ensure you have a backup (via export) if needed.

Helpful Resources