When developing an app, you can use the Wix CLI to work with existing app versions in the app dashboard. This allows you to add new features to your app using the CLI without having to migrate the entire app to your CLI project.
Follow these steps to integrate your app with the CLI.
Before getting started, make sure you have the following set up:
To extend an existing app with a new Wix CLI project:
Run the following command:
When asked what you would like to do, select Add new extensions for an existing Wix app.
Select the app to extend.
Enter a folder name for your project. The folder name is the name of the directory containing your project's local files.
Once the process is complete, you'll have all the files for your app in a local directory with the folder name you chose. The project includes a starter dashboard page in src/extensions/dashboard/pages/my-page/. For more information about the local files generated for your app, see About the App Project Structure.
When working on the CLI extension project locally or in preview versions, you can only work with the app extensions that are registered in your CLI project. Other app extensions from your app's dashboard are still loaded into your development site where you can preview and test them, but they will use their production versions.
Changes to your extension's local files will not be reflected in your app's dashboard until you create a new app version.
Your app won't be active on your development site at this stage, however, you can preview and test it in a local development environment.
To set up a local development environment, run the wix app dev command.
To test your app, you need a development site. If your project doesn't have one yet, the CLI asks you to press Enter to open the app installation page in your browser. There, select one of your development sites or click Create Dev Site, and install the app. After that, the CLI prints links to open the different parts of your app on the development site in your browser.
After completing the above steps, you have integrated your existing app into a Wix CLI project that you can experiment with and test locally.
You can now:
Last updated: 11 November 2026