Creates a new Wix app project.
For a step-by-step walkthrough, see Quick Start a Wix-Managed App with the Wix CLI for Apps.
Note: This command is provided by the @wix/create-new package, which is invoked through npm create. It's a separate package from @wix/cli and doesn't require an existing project.
Run this command in the parent directory where you want the project folder.
The -- separator tells npm to forward everything after it to the @wix/create-new package, instead of consuming the flags itself.
Note: If you don't include flags, the command runs in interactive mode, prompting you for an app name and letting you pick a template. To run non-interactively, pass --app-name.
The following flags are available for the app command:
| Flag | Description |
|---|---|
--app-name <app-name> | Optional. The display name for your new app. Must be 1 to 30 characters long and can't contain the reserved word wix (case-insensitive). If omitted, the CLI prompts you for an app name in interactive mode. Passing this flag runs the command non-interactively. |
-t, --template <template-id> | Optional. The ID of the app template to scaffold from. If omitted, the CLI prompts you to pick a template in interactive mode. If you pass --app-name without this flag, the CLI uses the default blank template. For valid IDs, see App template IDs. |
--extend-app-id <extend-app-id> | The ID of an existing app to add new extensions to. If you pass this flag, the CLI scaffolds locally against that app instead of registering a new one. Pass it together with --app-name. You can't combine it with --template. |
The following CLI app templates are available. To scaffold from one of them, pass its ID with --template.
| Template | ID | Description |
|---|---|---|
| Custom Products Catalog | 24493a0d-18f2-4f68-b6d5-55992cef7daa | Add or remove products via a dashboard page using Stores APIs. |
| Mixpanel Analytics | c442b755-2276-4336-918a-915865a9fa2b | Build data-driven apps using an embedded script and dashboard page. |
| Site Popup | 46746ee0-e0b0-4971-be34-f3ea94dd979b | Design interactive popups via a dashboard page. |
| Inventory Countdown | 2ff7a5ae-d116-4c06-9394-7d7493428d0e | Develop a Wix Stores site plugin that's added to product pages. |
| Chart Widget | 5fcf03b8-46ba-499b-8dbb-40ecf811aceb | Create a widget with dynamic and customizable charts. |
Scaffold an app interactively, with prompts for the app name and template:
Scaffold an app non-interactively, with a known template ID:
Add new extensions to an app you already own. This form requires an interactive terminal:
The command creates a new folder for your app project. The folder follows the standard project structure for Wix CLI projects.
In addition to scaffolding the standard layout, this command:
--extend-app-id. The new app appears in your account under Custom Apps.wix.config.mjs with your app's identifiers, such as appId and projectId.Last updated: 10 November 2026