Wix Project Structure

Projects created with the Wix CLI follow a standard project structure. Wix-managed apps and Wix-managed headless projects each have their own structure, but both follow the same ideas, so the conventions you learn on one carry over to the other. This holds whether you create the project yourself or an AI agent creates it for you with Wix Skills. Studio Two sites, and Wix Studio and Wix Editor sites developed through Git integration, use their own layouts. Those layouts are covered below.

Underlying structure

The Wix CLI generates a base structure for every project it creates. An app project centers on extensions and backend code, and doesn't include a site frontend. A headless project uses the Astro web framework and also contains the frontend for the site. At a high level, both structures organize a project into a few areas:

  • Source code: Your project's own code. For apps, this is extensions and HTTP endpoints. For headless projects, it also includes the Astro frontend pages, components, and layouts that render the site.
  • Static assets: Files served as-is, such as images and fonts.
  • Configuration: Root-level files that identify your project to Wix and control how it builds.

Convention over configuration

Both structures follow conventions rather than requiring manual configuration. You place code in the designated locations and register your extensions in a single configuration file. The platform handles the rest. You don't configure routing, build tooling, or hosting yourself.

Projects that bring their own code

These structures exist only in projects the Wix CLI creates. If you bring existing code to Wix instead, such as a design imported from Claude Design, or another codebase you connect to the platform, then the project keeps the existing structure. Wix works with your code as it is rather than reorganizing it into the CLI layout.

Studio Two sites

A Studio Two site is built on Astro. You open the project in the Code tab. Extensions live under src/extensions/, in site, backend, and dashboard folders. The file src/extensions.ts registers the extensions in the project. For the layout, see About the Development Environment.

Note: Studio Two is rolling out and is not yet available to all users.

Wix Studio and Wix Editor sites

Wix Studio and Wix Editor sites developed with the JavaScript SDK through Git integration use a different layout, one that mirrors the Wix Editor's code structure rather than the Wix CLI layouts. That layout is documented separately in Git Repository File Structure.

See also

Last updated: 11 November 2026

Did this help?