> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - If a reference page seems to be missing its schema (parameters, return types, or type definitions), append `?schema=true` to its `.md` URL (e.g. `https://dev.wix.com/docs/contexts/contexts/stores/category-info/use-category-info-context.md?schema=true`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt
> - To build a Wix site agentically, follow https://www.wix.com/headless/skill.md

## Resource: About the Headless Project Structure

## Article: About the Headless Project Structure

## Article Link: https://dev.wix.com/docs/wix-cli/cli-for-headless/project-structure/about-the-headless-project-structure.md

## Article Content:

# About the Headless Project Structure

This article describes the structure of a Wix CLI headless project. The CLI uses a standardized project structure based on the Astro web framework.

A headless project includes Astro files, Wix-specific files, [Wix skills](https://dev.wix.com/docs/api-reference/articles/ai-tools/about-wix-skills.md), directories for extensions and configuration, and an Astro frontend for the site you build: [pages](https://docs.astro.build/en/basics/astro-pages/), [components](https://docs.astro.build/en/basics/astro-components/), [layouts](https://docs.astro.build/en/basics/layouts/), and more.

## Project file structure

```text
.
├── .agents/
│     └── skills/
├── .astro/
├── .wix/
├── dist/
├── node_modules/
├── public/
├── src/
│   ├── extensions/
│   ├── pages/
│   ├── Frontend files
│   ├── env.d.ts
│   └── extensions.ts
├── .env.local
├── .gitignore
├── astro.config.mjs
├── package.json
├── tsconfig.json
└── wix.config.json
```

A headless project contains the Astro frontend for the site you build, and can also include dashboard and backend extensions, in an `extensions/` folder registered by `extensions.ts`. Its frontend files under `src/` depend on the template you start from.

> **Note:** The CLI creates some of these folders and files as you work. For example, `.astro/`, `dist/`, and `node_modules/` are created when you install dependencies or build and run your project.

## Folders and files

| Folder or file | What it's for | Details |
| --- | --- | --- |
| `.agents/skills/` | The [Wix skills](https://dev.wix.com/docs/api-reference/articles/ai-tools/about-wix-skills.md) that let AI agents perform CLI tasks for you, with one folder per skill, such as `wix-app` and `wix-headless`. The skills are available to the AI tools you use, such as Claude Code, Cursor, and GitHub Copilot. The CLI also generates agent-instruction files, such as `AGENTS.md` and `CLAUDE.md`, for those tools. | |
| `.astro/` | Astro's build and type files, managed by Astro. | |
| `.wix/` | Configuration and log files related to the Wix environment. This directory contains internal data. Don't edit it. | |
| `dist/` | Your project's production build output, created when you build the project. | |
| `node_modules/` | The npm dependencies installed for your project. | |
| `public/` | Static assets served at your site's root. | |
| `src/` | The source directory, with all the source code and core resources of your project. | |
| `src/extensions/` | The default location for the extensions you generate, one folder per extension. | [src/extensions/](https://dev.wix.com/docs/wix-cli/cli-for-headless/project-structure/folders-and-files/src-extensions.md) |
| `src/pages/` | Your frontend routes, one page per `.astro` file, and your backend HTTP endpoints under `src/pages/api/`. | [src/pages/](https://dev.wix.com/docs/wix-cli/cli-for-headless/project-structure/folders-and-files/src-pages.md) |
| Frontend files | [Components](https://docs.astro.build/en/basics/astro-components/) and other supporting files under `src/`, such as [layouts](https://docs.astro.build/en/basics/layouts/) and [styles](https://docs.astro.build/en/guides/styling/). The exact set follows standard Astro conventions and depends on the template you start from. For what each template includes, see [Astro Templates for Wix-Managed Headless](https://dev.wix.com/docs/go-headless/wix-managed-headless/full-integration-astro/get-started/astro-templates.md). | |
| `.env.local` | [Environment variables](https://dev.wix.com/docs/go-headless/wix-managed-headless/full-integration-astro/development/environment-variables/about-environment-variables-in-the-cli.md) required to set up authentication for your local development environment. Don't edit any of the `WIX_CLIENT` variables. | |
| `.gitignore` | Lists the paths Git excludes from version control. | |
| `astro.config.mjs` | The Astro configuration file, including the `wix()` integration settings. | |
| `package.json` | Your project's dependencies and scripts. | |
| `src/env.d.ts` | TypeScript type declarations for the Astro environment. | |
| `src/extensions.ts` | Registers all your project's extensions. | [extensions.ts](https://dev.wix.com/docs/wix-cli/cli-for-headless/project-structure/folders-and-files/extensions-ts.md) |
| `tsconfig.json` | Configures the TypeScript compiler. | |
| `wix.config.json` | Defines the identifiers that connect your local code to your Wix project. Don't edit this file. | |