How to Start

You can start the app-creation flow from two places:

• Applications Manager — click the New Application button (or its dropdown → Create Application). See Applications Manager for details on that screen.

• Inside a Package — when creating an app that will belong to an existing package, use the package's own "Add Application" entry point. The creation dialog is two steps: choose the type first, then fill in the details.

If the AI builder is enabled for your workspace, clicking New Application opens the AI creation screen first. To create a blank app via the manual form, click Or start blank → Create Manually at the bottom of that screen.

Steps: Creating a Blank Application

1. Open the Applications Manager and click New Application.

2. If the AI builder screen appears, click Or start blank, then Create Manually to proceed to the manual form.

3. Select an Application type from the four type cards (Web App, Mobile App, Copilot Chat, Display).

4. Enter a Name for your application. The subdomain is auto-generated from the name as you type; you can edit it manually.

5. Optionally add Tags to help organize the app in the Applications Manager.

6. Verify or update the Sub-domain / Path. Follow the naming rules described in Subdomain Rules below.

7. Optionally fill in About this application with a short description.

8. If creating a Web App, confirm or change the Base Variant (Desktop is selected by default).

9. Select the target Workspace if your account has access to multiple workspaces.

10. Click Create. The page builder opens immediately with a template picker. Select Blank Page or choose a pre-built template to get started.

Application Types

The creation form presents four application types as selectable cards. The type you choose determines the builder interface, available settings, and which features your app can use.

Note: The app type is fixed once created — choose carefully. You cannot change an app's type after it has been created. If you need a different type, you must create a new application.

Creation Form Fields

Subdomain Rules

The sub-domain (also called the path) forms part of your app's published URL. It is auto-generated from the application name when you type, but you can edit it before clicking Create. Once the app is created the subdomain is permanently locked — it cannot be changed from the Edit Details panel.

Note: Subdomain rules: lowercase, numbers, hyphens only. The sub-domain field enforces the following constraints automatically: Only lowercase letters (a–z), digits (0–9), and hyphens (-) are allowed.No spaces or other special characters.Cannot start or end with a hyphen.Cannot contain two or more consecutive hyphens (--).Maximum length: 63 characters.

Base Variant (Web Apps)

When creating a Web App, you choose a Base Variant: the primary device the app is initially built and optimized for. The available options are:

• Desktop (default) — the canvas opens at a desktop breakpoint. You can add mobile variants later inside the builder.

• Mobile — the canvas opens at a mobile breakpoint, giving priority to a narrow viewport layout.

The Base Variant is shown in the Type column tag (e.g., Web App / Desktop) and is fixed after creation.

After Creation

Once you click Create, the app is provisioned and the builder opens automatically. You are presented with a template picker — select Blank Page to start from scratch, or choose a pre-built template to use as a foundation.

The app is immediately visible in the Applications Manager list. Its type, subdomain, and base variant are now locked. You can update the name, tags, and description at any time using the Edit Details action in the row overflow menu.

Editing App Details

To update an existing app's metadata without opening the builder:

1. In the Applications Manager, click the ⋯ menu on the app row.

2. Select Edit Details.

3. Update the Name, Tags, or About this application as needed.

4. Click Save.

The following fields are read-only in Edit Details and cannot be changed after creation:

• Application Type

• Sub-domain / Path

• Base Variant

Creating an App Inside a Package

When you are working inside a package, the app-creation entry point uses a two-step dialog rather than the single-form flow:

1. Inside the package, click Add Application.

2. Step 1 — Type: Select the application type (Web App, Mobile App, Copilot Chat, or Display). Click Next.

3. Step 2 — Details: Fill in the name, subdomain, tags, description, and base variant (for Web Apps). Click Create.

4. The new app is added to the package and appears in both the package view and the main Applications Manager list.

Cloning an Existing Application

Cloning creates a fully independent copy of an application with a new name and subdomain. The clone is not linked to the original — subsequent changes to either app do not affect the other.

1. In the Applications Manager, hover over the app you want to clone and click its ⋯ menu → Clone.

2. In the Clone dialog, review and optionally update the Name. The default is {Original Name} (Clone).

3. Review and optionally update the Sub-domain. The default is {original-id}-clone. The subdomain must be unique within the target workspace.

4. Select the target Workspace if you want the clone to live in a different workspace.

5. Click Clone. The cloned application appears in the list and is immediately ready to edit.

Note: Note on packages. Packages cannot be cloned. The Clone action only appears for Web Apps, Mobile Apps, Copilot Chats, Displays, Modules, and Text to App applications.