Projects created with the Wix CLI share a single project structure. Whether you create a Wix-managed app or a Wix-managed headless project, or an AI agent creates one for you with Wix Skills, your code is organized the same way. The tools, commands, and conventions you learn on one carry over to the other.
Projects created with the Wix CLI are built on the Astro web framework, and the CLI generates the same base structure for every project it creates. At a high level, that structure organizes a project into a few areas:
The shared structure follows 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.
The shared structure only exists 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.
Editor and Studio sites developed with the JavaScript SDK through Git integration also use a different layout, one that mirrors the Wix Editor's code structure rather than the Astro-based CLI layout. That layout is documented separately in Git Repository File Structure.
Last updated: 2 August 2026