Deprecated
The Astro-based Wix CLI for Apps is deprecated. New projects should use the Wix CLI for Apps.
Creates a new folder with a Wix app project. The folder follows the Astro-based app project structure.
In addition to scaffolding the project structure, this command:
Populates wix.config.json with your app's appId, a projectId set to the project folder name, and projectType. The appId depends on whether you create a new app or add extensions to an existing one:
appId to its ID.appId to the ID of the app you're adding extensions to.Either way, you can find the app in your account under Custom Apps.
If the parent folder isn't already in a Git repository, initializes one with an initial commit.
The command starts with a deprecation notice. In interactive mode, it then asks whether you still want to create an Astro-based app. Unless you confirm, the command exits without creating a project.
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 legacy-astro-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 wix as a separate word, in any letter case. If omitted, the CLI prompts you for an app name in interactive mode. Passing this flag runs the command non-interactively. When you pass this flag, the command shows the deprecation notice and continues without asking whether you want to create an Astro-based app. |
-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. |
-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:
Last updated: 11 November 2026