Creates a new Wix app project.
Run this command in the parent directory where you want the project folder. 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.