> 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`).
> - 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/command-reference/project-creation/create-app.md

## Article Content:

# npm create @wix/new app

Creates a new Wix app project. Run this command in the parent directory where you want the project folder. The command registers a new app in your Wix account (or extends an existing app), scaffolds the chosen app template into a new local folder, and installs dependencies.

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.

For a step-by-step walkthrough, see [Quick Start an App](https://dev.wix.com/docs/wix-cli/guides/get-started/quick-start-an-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

```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](#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 standard [project structure](https://dev.wix.com/docs/wix-cli/guides/get-started/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.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/command-reference/project-commands/dev.md).