CLI Documentation Notice
You're viewing documentation for the new Wix CLI, which we recommend for all new projects.
This article describes the structure of a Wix CLI project. The CLI uses a standardized project structure based on the Astro web framework for both app projects and headless projects.
Every CLI project includes Astro files, Wix-specific files, and directories for extensions and configuration. Headless projects contain additional Astro development files to define the project's frontend, such as pages, components, layouts, and more.
Note: Some of these files and directories don't exist when you initially create your project. They're created when you add extensions, and when you build or run your project.
Astro build and type files. Managed by Astro.
Contains configuration and log files related to the Wix environment.
Caution: This directory contains internal data. Don't edit it.
Contains the production build output of your project. This directory is created automatically when you build your project. You generally don't need to edit files here.
Static files served at the root of your site.
Source directory. Contains all the source code and core resources of your application.
You can organize your extensions into multiple custom folders and reference their paths in the extension.ts file.
The configuration file where you register all extensions for your project. Learn more about the extension.ts file.
Astro configuration file.
It contains environment variables required to setup authentication for your local development environment. Don't edit any of the WIX_CLIENT variables.
Holds various metadata relevant to the project. It manages the project's dependencies, scripts, and more.
Configuration for the TypeScript compiler.
Defines basic information about your project, including appId of your private app, and projectId of your headless project. Don't edit this file.