About the Wix CLI

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.

What you can build

The CLI generates the complete project structure needed for Wix app development. You can:

  • Generate extensions like custom dashboard pages, event handlers, site widgets, and embedded scripts.
  • Call Wix JavaScript SDK methods directly. In Wix CLI apps, token management and authentication are handled for you with no client setup.
  • Build extensions with TypeScript, React components, and the Wix Design System for a native Wix look and feel.

Project structure

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.

Development sites

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.

Develop and test apps

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.

Build, preview, and release apps

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.

Hosting and infrastructure

The CLI provides a serverless hosting solution where scaling, resource allocation, and maintenance are fully managed by Wix:

  • Static sites hosting powered by a global CDN for fast content delivery.
  • Serverless architecture for full-stack apps without managing servers.
  • Automatic SSL certificates provisioned and renewed for you.
  • Session management middleware that handles session tokens and cookies for the current site visitor.

Keep the CLI up to date

Check which version of the CLI you have:

Copy

Upgrade to the latest:

Copy

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>.

Earlier versions of the CLI

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.

See also

Last updated: 11 November 2026

Did this help?