> To build a Wix site agentically, follow https://www.wix.com/headless/skill.md
> 
> 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

## Resource: create legacy-astro-app

## Article: create legacy-astro-app

## Article Link: https://dev.wix.com/docs/wix-cli/legacy-clis/astro-based-wix-cli-for-apps/command-reference/project-creation-commands/create-legacy-astro-app.md

## Article Content:

# npm create @wix/new legacy-astro-app

<blockquote class="warning">

**Deprecated**

The Astro-based Wix CLI for Apps is deprecated. New projects should use the [Wix CLI for Apps](https://dev.wix.com/docs/wix-cli/cli-for-apps/about-the-wix-cli-for-apps.md).

- To find out which structure a project uses, see [Determine Which CLI Your Project Uses](https://dev.wix.com/docs/build-apps/develop-your-app/develop-an-app-with-the-cli/project-development/determine-which-cli-your-project-uses.md).
- To migrate an existing app to the new Wix CLI, see [Migrate an Astro-based CLI App to the New Wix CLI](https://dev.wix.com/docs/build-apps/develop-your-app/develop-an-app-with-the-cli/migrate-an-app-to-the-new-cli/migrate-an-app-from-the-astro-based-cli/migrate-an-astro-based-cli-app-to-the-new-wix-cli.md).

</blockquote>

Creates a new folder with a [Wix app](https://dev.wix.com/docs/build-apps/get-started/overview/about-wix-apps.md) project. The folder follows the [Astro-based app project structure](https://dev.wix.com/docs/wix-cli/legacy-clis/astro-based-wix-cli-for-apps/project-structure/astro-based-app-project-structure.md).

In addition to scaffolding the project structure, this command:

- Populates [`wix.config.json`](https://dev.wix.com/docs/wix-cli/legacy-clis/astro-based-wix-cli-for-apps/project-structure/astro-based-app-project-structure.md#wixconfigjson) with your app's `appId`, a `projectId` set to the project folder name, and `projectType`. The `appId` depends on whether you create a new app or add extensions to an existing one:
  - A new app: The command registers a new app in your Wix account and sets `appId` to its ID.
  - An existing app: The command sets `appId` to the ID of the app you're adding extensions to.

  Either way, you can find the app in your account under [Custom Apps](https://manage.wix.com/studio/custom-apps).
- If the parent folder isn't already in a Git repository, initializes one with an initial commit.

The command starts with a deprecation notice. In interactive mode, it then asks whether you still want to create an Astro-based app. Unless you confirm, the command exits without creating a project.

> **Note:** This command is provided by the [`@wix/create-new`](https://www.npmjs.com/package/@wix/create-new) package, which is invoked through `npm create`. It's a separate package from `@wix/cli` and doesn't require an existing project.

## Usage

Run this command in the parent directory where you want the project folder.

```bash
npm create @wix/new@latest -- legacy-astro-app [flags]
```

The `--` separator tells `npm` to forward everything after it to the `@wix/create-new` package, instead of consuming the flags itself.

> **Note:** If you don't include flags, the command runs in interactive mode, prompting you for an app name and letting you pick a template. To run non-interactively, pass `--app-name`.

## Flags

The following flags are available for the `legacy-astro-app` command:

| Flag | Description |
| ---- | ----------- |
| `--app-name <app-name>` | Optional. The display name for your new app. Must be 1 to 30 characters long and can't contain `wix` as a separate word, in any letter case. If omitted, the CLI prompts you for an app name in interactive mode. Passing this flag runs the command non-interactively. When you pass this flag, the command shows the deprecation notice and continues without asking whether you want to create an Astro-based app. |
| `-t`, `--template <template-id>` | Optional. The ID of the app template to scaffold from. If omitted, the CLI prompts you to pick a template in interactive mode. If you pass `--app-name` without this flag, the CLI uses the default blank template. For valid IDs, see [App template IDs](https://dev.wix.com/docs/wix-cli/legacy-clis/astro-based-wix-cli-for-apps/command-reference/project-creation-commands/create-legacy-astro-app.md#app-template-ids). |
| `--extend-app-id <extend-app-id>` | The ID of an existing app to add new extensions to. If you pass this flag, the CLI scaffolds locally against that app instead of registering a new one. Pass it together with `--app-name`. You can't combine it with `--template`. |
| `-h`, `--help` | Display help for the command. |

## App template IDs

The following [CLI app templates](https://dev.wix.com/apps-templates?filter=cli) are available. Pass the ID via `--template` to scaffold against the corresponding template non-interactively.

| Template | ID | Description |
| -------- | -- | ----------- |
| Custom Products Catalog | `24493a0d-18f2-4f68-b6d5-55992cef7daa` | Add or remove products via a dashboard page using Stores APIs. |
| Mixpanel Analytics | `c442b755-2276-4336-918a-915865a9fa2b` | Build data-driven apps using an embedded script and dashboard page. |
| Site Popup | `46746ee0-e0b0-4971-be34-f3ea94dd979b` | Design interactive popups via a dashboard page. |
| Inventory Countdown | `2ff7a5ae-d116-4c06-9394-7d7493428d0e` | Develop a Wix Stores site plugin that is added to product pages. |
| Chart Widget | `5fcf03b8-46ba-499b-8dbb-40ecf811aceb` | Create a widget with dynamic and customizable charts. |

## Examples

- Scaffold an app interactively, with prompts for the app name and template:

  ```bash
  npm create @wix/new@latest -- legacy-astro-app
  ```

- Scaffold an app non-interactively, with a known template ID:

  ```bash
  npm create @wix/new@latest -- legacy-astro-app \
    --app-name "My App" \
    --template 24493a0d-18f2-4f68-b6d5-55992cef7daa
  ```

- Add new extensions to an app you already own:

  ```bash
  npm create @wix/new@latest -- legacy-astro-app --app-name "My App" --extend-app-id <existing-app-id>
  ```