About the Wix CLI

We're actively working on improving the CLI, adding features, and providing comprehensive documentation. Help us improve the CLI by providing feedback and suggestions, and join our community of Wix developers on Discord.

CLI Documentation Notice

You're viewing documentation for the new Wix CLI, which we recommend for all new projects.

The Wix CLI is a unified command-line tool for creating, developing, and deploying Wix apps and Wix Headless projects. It simplifies development by automatically generating a complete project structure and handling initial setup and configuration. It also provides commands to generate extensions and manage your project throughout development. This allows you to focus on building the unique features of your project.

The Wix CLI:

  • Provides a modern, streamlined development experience.
  • Makes it easy to develop, test, and manage both app and headless projects.
  • Provides a fully managed hosting solution on Wix’s servers.

Modern development experience

The CLI uses a standardized project structure based on the Astro web framework. Astro is a JavaScript-based web framework designed for building fast, content-focused websites. It also supports backend development with features like Astro endpoints.

The CLI allows you to:

  • Generate extensions to quickly add functionality to your project, such as custom dashboard pages and event handlers.
  • Call Wix JavaScript SDK methods directly, as the CLI handles token management and authentication for you, eliminating the need to set up a Wix Client.
  • Test projects locally with hot reloading.
  • Create shareable preview versions of your project for collaboration.

Wix app support

The CLI generates the complete project structure needed for Wix app development. You can add extensions built with TypeScript, React components, and the Wix Design System, providing a native Wix look and feel.

Development sites

When developing apps, you can test your functionality using development sites. These are premium Wix sites that you can use for app testing. You can maintain up to five development sites simultaneously for testing different aspects of your app.

Headless project support

The CLI simplifies and streamlines Wix Headless project development, making it easy to work with Wix's business solutions and dashboard, and allowing you to build your own custom frontend using any technology supported by Astro.

When you create a headless project, the CLI generates the code for an Astro site so you can begin developing immediately.

Project's private app

When you create a headless project, the CLI sets up a private app that allows you to add features to your project through extensions. The app also acts as the OAuth app that handles authentication for your project's frontend. This private app can't be shared with others, it's only for use in your headless project.

Custom domain support

You can use a custom domain for headless frontends to provide a branded experience for users.

Hosting and infrastructure

The CLI provides a serverless hosting solution where scaling, resource allocation, and maintenance are fully managed, so you don't have to worry about infrastructure.

The main features include:

  • Static sites hosting: The hosting environment is powered by a global CDN that ensures fast and reliable content delivery to users.
  • Serverless architecture: Run full-stack apps without managing servers. Scaling and resource management are handled automatically by Wix.
  • Automatic SSL certificates: SSL certificates are automatically provisioned and renewed, ensuring secure connections.
  • Session management middleware: A middleware manages session tokens and cookies for the current site visitor, allowing you to use stateful session APIs like e-commerce carts, site visitor authentication, and more.

Get started

Did this help?