# `smallforce app init`

Create an application record and write smallforce.json

This page is generated from the same Commander definition shipped in SmallForce CLI 0.1.7. Run `smallforce app init --help` locally to view the same reference for your installed version.

## Complete command help

```text
Usage: smallforce app init [options]

Create an application record and write smallforce.json

Options:
  --name <name>              Human-readable application name
  --slug <slug>              DNS-safe application slug
  --dir <path>               Project directory; defaults to the slug
  --template <template>      Built-in astro, presentations, or worker template; also accepts a Git
                             URL or local directory
  --build-command <command>  Override the template build command
  --output <directory>       Override the template build output directory
  --entrypoint <path>        Override the Worker entrypoint relative to the build output
  --assets-directory <path>  Override the static assets directory relative to the build output
  --no-assets                Create an API-only Worker without static assets
  --package-manager <name>   Package manager for a custom template: bun, npm, or pnpm; built-ins use
                             Bun (default: "bun")
  --no-install               Do not install template dependencies
  --api-key <key>            SmallForce API key, or set SMALLFORCE_API_KEY
  --backend-url <url>        SmallForce backend URL, or set SMALLFORCE_BACKEND_URL
  --json                     Print stable machine-readable JSON
  --text                     Print human-readable text
  --format <format>          Output format: text or json
  -h, --help                 display help for command
```

## Related reference

- [`smallforce app`](/docs/cli/commands/app): Parent command and related operations.
- [CLI installation and authentication](/docs/cli/getting-started): Install the CLI and configure an API key.
- [CLI JSON output](/docs/cli/json-output): Use stable machine-readable output in scripts and agents.