About the Wix CLI

The Wix CLI is the command-line tool for creating, developing, and deploying Wix-managed headless projects. It generates a complete project structure, handles initial setup and configuration, and provides commands to manage your project throughout development.

New CLI projects include Wix skills, so AI tools can perform CLI tasks for you. This lets you focus on building the unique features of your project.

To get started, see Quick Start with the Wix CLI.

Note: Headless projects created with the CLI are Wix-managed headless projects. This is the recommended path for new headless projects.

This article covers the CLI as a tool and the project it generates. For what Wix-managed headless is, what you get, and how to choose it, see About Wix-Managed Headless.

What you can build

The CLI streamlines headless project development, so you can work directly with Wix's business solutions and build a custom frontend using any technology supported by Astro. You can:

  • Generate extensions like custom dashboard pages, event handlers, and backend APIs.
  • Call Wix JavaScript SDK methods directly. The CLI handles token management and authentication for you.
  • Use a custom domain for your headless frontend to provide a branded experience.

Project structure and Astro

The CLI uses a standardized project structure based on the Astro web framework. Astro offers a performance-focused architecture, partial hydration, and a flexible component model that lets you mix vanilla HTML/CSS/JS with React, Vue, or Svelte components as needed.

The CLI also supports backend development with HTTP endpoints.

For a per-folder breakdown of the generated project, see Wix CLI Project Structure.

If you have an existing Astro project, you can connect it to Wix instead of creating a new one. You can also open and develop projects you started with Wix Vibe, the AI-driven UI for Wix-managed Headless, locally with the CLI.

Develop and test projects

As you work locally with the CLI, you can open the local version of your project's site or dashboard in your browser by running the dev command. The development environment supports hot reloading, so any changes you make to your code are immediately reflected in the browser.

Build, preview, and release projects

After developing and testing your project locally, you can build it, create shareable previews, and release it to production. For more information, see Build and Deploy a Project with the Wix CLI.

Keep the CLI up to date

Check which version of the CLI you have:

Copy

Upgrade to the latest:

Copy

Note: If the latest version of the CLI includes a new command, you'll need to add the new command to your package.json file.

See also

Did this help?