Build and Deploy an App with the Wix CLI

After developing and testing your Wix CLI app locally, you can take it to production. This article guides you through that process. You can also use Wix Skills to implement the build and deploy process. For app testing guidelines, see App Checks and Testing Guide.

For instructions on creating an app project, see Quick Start an App.

Before you begin

Before getting started, make sure that you have Node.js (v24.22.1 or higher).

Step 1 | Build the project

Run the build command to build the assets for your project:

Copy

The command writes the build output to the dist/ folder. The preview and release commands upload this build output and don't rebuild your project, so run wix app build after every change before you create a preview or release a version.

Step 2 (Optional) | Create preview URLs

A preview lets you test your app before you release it. Each preview stays as it was when you created it, so later changes to your project don't affect it. A preview doesn't create an app version.

To push your project to Wix's servers for hosting and create preview URLs, run the preview command:

Copy

The command prints Site, Editor, and Dashboard links. Each link opens an installation page where you select a development site and click Install App. The link installs the preview on that site, and then opens that site, its editor, or its dashboard. You can share the links with others.

Step 3 | Release your project

To push your project to Wix's servers for hosting and releasing a version, run the release command and follow the prompts.

Note: A release can include at most 5,000 static files.

Copy

The CLI guides you through the process of releasing a new app version:

  1. The CLI uploads the build output in dist/ to Wix's servers. If your project includes backend event extensions, the CLI shows a warning about them before it continues.
  2. The CLI prompts for an optional comment that describes the changes in this version. The comment isn't shown to users. To skip this prompt, pass the comment with the --comment flag.
  3. The CLI creates the version and prints its number, such as 1.0.0, with links to next steps.

To choose whether the release is a major or minor version, use the --version-type flag with major or minor.

An app version allows you to publish an app to the Wix App Market or install it on a site with a direct install URL. You can view your app versions in the app dashboard.

Learn more about app distribution.

Next steps

You now have a fully working app.

Use the following resources to continue building your app:

Last updated: 11 November 2026

Did this help?