Create an Application

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 New Application button (or its dropdown → Create Application). 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.

Note: Creating an app requires a base domain configured for your workspace. If none is set, New Application is disabled — ask your administrator.

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.

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

6. Check the Sub-domain / Path. It is generated from the name as you type; edit it if needed, following the 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. If the Workspace field is shown, select the target workspace. It appears only when you create the app from the all-workspaces view.

10. Click Create application. 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: The sub-domain field enforces these rules 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.

• Must be unique. If the sub-domain is already taken, creation fails with "Sub-domain should be unique. Please enter a different sub-domain." (or "Path should be unique…" when apps are served on paths).

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.

• Tablet — the canvas opens at a tablet breakpoint.

• 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 application, 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. When you view apps across all workspaces, the dialog also shows Workspace.

4. Click Update.

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 New Application (or its dropdown → Create 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. Apps inside a package are listed only in that package's Applications tab, not in the top-level Applications 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 generated from the clone's name (for example, my-app-clone). The subdomain must be unique.

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

5. Click Clone. The new app's details page opens as soon as the clone is created.

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