> ## Documentation Index
> Fetch the complete documentation index at: https://momentic.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# momentic-mobile init

> Scaffold a new Momentic mobile project in the current directory.

Creates a [`momentic.config.yaml`](/configuration/momentic-config) and the
project layout used by the rest of the mobile CLI. The command prompts before
overwriting any existing files.

```bash theme={null}
npx momentic-mobile init
```

New mobile projects are scaffolded with `fileFormat: v2`. Sample tests and
modules emitted by the
[onboarding wizard](https://www.npmjs.com/package/@momentic/wizard) are written
in the simplified format directly, so no follow-up migration is needed. Existing
v1 mobile projects should run
[`momentic-mobile migrate simplified-format`](/get-started/migrate-to-simplified-format)
instead of re-running `init`.

## Options

<ParamField path="--name <name>" type="string">
  Project name to write into the generated `momentic.config.yaml`. When omitted,
  the wizard prompts for one and defaults to `app`.
</ParamField>

## Examples

Scaffold a project in the current directory:

```bash theme={null}
npx momentic-mobile init
```

Scaffold a project non-interactively with a fixed name:

```bash theme={null}
npx momentic-mobile init --name shopping-app
```