Deprecated
The Astro-based Wix CLI for Apps is deprecated. New projects should use the Wix CLI for Apps.
With the Wix CLI, you can develop, test, and release Wix apps from your terminal. This reference documents the commands for creating and working in Astro-based app projects, and the CLI's global commands.
The sections of this article are organized by command type, and each section describes the syntax of its commands.
The commands you can use depend on where you run them:
This command scaffolds a new project. It's provided by the @wix/create-new package, so it runs through npm create, not as a wix command, before a project exists locally.
| Command | Description |
|---|---|
| npm create @wix/new app | Creates a new Wix app project, including registering a new app in your account (or extending an existing one) and scaffolding from a template. |
The project creation command uses this syntax:
Angle brackets mark a required part, and square brackets mark an optional part. Don't type the brackets.
The -- separator forwards everything after it to the @wix/create-new package instead of consuming the flags itself.
These commands operate on an existing Astro-based app project. Run them from your project directory.
| Command | Description |
|---|---|
| dev | Starts a local development environment that serves your project. |
| dev-site | Manages the development site used by the current app. |
| build | Builds your project. |
| generate | Generates an extension for your project. |
| schema | Prints a JSON schema of the available extension types and their required inputs. |
| preview | Creates an online preview of your built project. |
| release | Starts a process that guides you through releasing your project. |
| env | Manages your project's environment variables on Wix's servers. |
| skills | Manages the Wix skills in your project. |
Project commands follow this general form:
Angle brackets mark a required part, and square brackets mark an optional part. Don't type the brackets.
Where:
<command> is the primary action (for example, dev, build, release)[subcommand] is a secondary action for commands that have subcommands (for example, set in wix env set)[flags] are parameters that modify the command's behaviorThese commands work outside the context of a specific project. To run them outside a project, install the CLI globally:
The CLI needs Node.js 24.18 or later.
| Command | Description |
|---|---|
| login | Logs in to your Wix account. |
| logout | Logs out of your Wix account. |
| whoami | Displays the email address of the logged-in Wix user. |
| telemetry | Opts in or out of sending usage information and error reports (telemetry) to Wix. |
| account | Manages your Wix account, including its domains. |
| token | Prints the current access token, account-level or site-scoped, for direct REST API calls. |
Last updated: 10 November 2026