App projects use one of three project structures. Before you follow any guide for an app project, identify which structure it uses, because the structure decides which commands you run and how your extensions are declared.
To find which structure your project uses, check the following against the table below:
package.json file.| Structure | Configuration files in the root folder | Dependency in package.json |
|---|---|---|
| The new Wix CLI, described in About the App Project Structure | wix.config.mjs | @wix/custom-extensions |
| The Astro-based structure, described in Astro-based App Project Structure | wix.config.json and astro.config.mjs | @wix/astro |
| The Legacy Wix CLI for Apps, described in Legacy App Project Structure | wix.config.json | @wix/cli-app |
Note: Both the Astro-based and the new structure have src/extensions.ts, so its presence rules out the legacy Wix CLI for Apps but doesn't distinguish between the other two.
Both earlier structures have a migration path to the new Wix CLI. To choose yours, see About Migrating an App to the New Wix CLI.
Last updated: 11 November 2026