> 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/cli-for-apps/command-reference/project-creation-commands/create-app.md

## Article Content:

# npm create @wix/new app

Creates a new [Wix app](https://dev.wix.com/docs/build-apps/get-started/overview/about-wix-apps.md) project.

For a step-by-step walkthrough, see [Quick Start a Wix-Managed App with the Wix CLI for Apps](https://dev.wix.com/docs/build-apps/develop-your-app/develop-an-app-with-the-cli/get-started/quick-start-a-wix-cli-app.md).

> **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 -- 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 `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. Passing this flag runs the command non-interactively. |
| `-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/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. Pass it together with `--app-name`. You can't combine it with `--template`. |

## App template IDs

The following [CLI app templates](https://dev.wix.com/apps-templates?filter=cli) are available. To scaffold from one of them, pass its ID with `--template`.

| 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's 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 --app-name "My App" --extend-app-id <existing-app-id>
```

## What the command does

The command creates a new folder for your app project. The folder follows the standard [project structure](https://dev.wix.com/docs/wix-cli/cli-for-apps/project-structure/about-the-app-project-structure.md) for Wix CLI projects.

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.mjs` with your app's identifiers, such as `appId` and `projectId`.
- Creates a Git repository with an initial commit.