The Wix CLI is the command-line tool for creating, developing, and deploying Wix apps. It generates a complete project structure, handles initial setup and configuration, and provides commands to generate extensions and manage your app throughout development.
To get started, see Quick Start a Wix CLI App.
The CLI generates the complete project structure needed for Wix app development. You can:
The CLI uses a standardized project structure. The project's main packages are @wix/cli, which provides the CLI commands, and @wix/custom-extensions, which provides the builders you use to define extensions. Each extension is defined in its own TypeScript file and registered in the project's src/extensions.ts file. The project's configuration is in wix.config.mjs. For the packages, see package.json.
The CLI also supports backend development with HTTP endpoints.
For a per-folder breakdown of the generated project, see About the App Project Structure.
When developing apps, you test your functionality on development sites, which are premium Wix sites used for app testing. You can maintain multiple development sites to test different aspects of your app.
Run wix app dev-site to list available sites, check the current site, select a different site, or create a new development site for the current app. When you select a site, or create one with the --select flag, the command prints an install URL and waits up to 2 minutes for you to install the app in a browser.
Wix apps aren't standalone web apps. They need to be installed on a Wix site to run.
To run your app locally, use the wix app dev command. If your app doesn't have a development site yet, the command prompts you to open the app installation page in your browser, where you select a development site or create a new one. The command then prints links to open your app on the development site, in the editor, and in the dashboard. The development environment supports hot reloading, so any changes you make to your code are immediately reflected in the browser.
In interactive sessions, press C while wix app dev is running to change the development site associated with an app. For non-interactive workflows, run wix app dev-site to list, select, create, or inspect the current development site.
After developing and testing your CLI app locally, you can build it, create shareable previews, and release new app versions for distribution. For more information, see Build and Deploy an App with the Wix CLI.
The CLI provides a serverless hosting solution where scaling, resource allocation, and maintenance are fully managed by Wix:
Check which version of the CLI you have:
Upgrade to the latest:
The scripts in your project's package.json file call wix app <command>, so npm run dev runs wix app dev. To run a command that doesn't have a script, use npx wix app <command>.
The Wix CLI replaces two earlier versions of the CLI for app projects: the Astro-based Wix CLI and the Legacy Wix CLI for Apps. Existing legacy projects still work. Their documentation is kept in Legacy CLIs, for maintaining apps built with them. To find out which version a project uses, see Determine Which CLI Your Project Uses.
Last updated: 11 November 2026