> 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 app

## Article: create app

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

## Article Content:

# npm create @wix/new 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 [Wix app](https://dev.wix.com/docs/build-apps/get-started/overview/about-wix-apps.md) project.

Run this command in the parent directory where you want the project folder. If you don't include flags, it runs in interactive mode, prompting you for an app name and letting you pick a template. To run non-interactively, use the `app` command together with the flags below.

> **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

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

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

## Flags

The following flags are available for the `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 the reserved word `wix` (case-insensitive). If omitted, the CLI prompts you for an app name in interactive mode. To run non-interactively, pass this flag together with `--template`. |
| `-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. Required whenever you pass `--app-name` to run non-interactively. 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-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. You can't combine it with `--app-name` or `--template`. The CLI always prompts you to pick a template, so this flag requires an interactive terminal (TTY). |
| `-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 -- app
```

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

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

Add new extensions to an app you already own. This form requires an interactive terminal:

```bash
npm create @wix/new@latest -- app --extend-app-id <existing-app-id>
```

## After the command runs

The command creates a new folder for your app 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 standard layout, this command:

- Registers a new app in your Wix account, unless you pass `--extend-app-id`. The new app appears in your account under [Custom Apps](https://manage.wix.com/studio/custom-apps).
- Populates `wix.config.json` with `appId`, `projectId`, and `projectType`.
- Creates a Git repository with an initial commit.

To start a local development environment, run [`wix dev`](https://dev.wix.com/docs/wix-cli/legacy-clis/astro-based-wix-cli-for-apps/command-reference/project-commands/dev.md).