Creates a new Wix app project. Run this command in the parent directory where you want the project folder. The command registers a new app in your Wix account (or extends an existing app), scaffolds the chosen app template into a new local folder, and installs dependencies.
If you don't include flags, it runs in interactive mode, prompting you for an app name and letting you pick a template. To run non-interactively, use the app command together with the flags below.
For a step-by-step walkthrough, see Quick Start an App.
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.
The -- separator tells npm to forward everything after it to the @wix/create-new package, instead of consuming the flags itself.
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. To run non-interactively, pass this flag together with --template. |
-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. Required whenever you pass --app-name to run non-interactively. 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. You can't combine it with --app-name or --template. The CLI always prompts you to pick a template, so this flag requires an interactive terminal (TTY). |
-h, --help | Display help for the command. |
The following CLI app templates are available. Pass the ID via --template to scaffold against the corresponding template non-interactively.
| 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 is 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.json with appId, projectId, and projectType.To start a local development environment, run wix dev.