# `smallforce app`

Initialize, deploy, inspect, and protect a generated application

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

## Subcommands

- [`smallforce app init`](/docs/cli/commands/app/init): Create an application record and write smallforce.json
- [`smallforce app deploy`](/docs/cli/commands/app/deploy): Build, upload, publish, and activate an immutable Preview release
- [`smallforce app status`](/docs/cli/commands/app/status): Read live application, environment, and release state
- [`smallforce app delete`](/docs/cli/commands/app/delete): Disable and remove an application from SmallForce
- [`smallforce app inspect`](/docs/cli/commands/app/inspect): Inspect the live app release, database, and files
- [`smallforce app db`](/docs/cli/commands/app/db): Inspect or query the application's implicit SQLite database
- [`smallforce app files`](/docs/cli/commands/app/files): Inspect files created or uploaded while the app is running
- [`smallforce app logs`](/docs/cli/commands/app/logs): Read application and runtime logs
- [`smallforce app events`](/docs/cli/commands/app/events): Read custom OpenTelemetry application events
- [`smallforce app analytics`](/docs/cli/commands/app/analytics): Read human visitor and crawler analytics
- [`smallforce app diagnostics`](/docs/cli/commands/app/diagnostics): Read request failures, rate limits, and runtime diagnostics
- [`smallforce app metrics`](/docs/cli/commands/app/metrics): Read request, latency, error, and response-size metrics
- [`smallforce app traces`](/docs/cli/commands/app/traces): List and inspect OpenTelemetry request traces
- [`smallforce app env`](/docs/cli/commands/app/env): Manage stable Preview, Production, and custom environment targets
- [`smallforce app var`](/docs/cli/commands/app/var): Manage plaintext variables for one explicit environment
- [`smallforce app secret`](/docs/cli/commands/app/secret): Manage write-only secrets for one explicit environment
- [`smallforce app release`](/docs/cli/commands/app/release): Inspect immutable application releases
- [`smallforce app security`](/docs/cli/commands/app/security): Read or replace optional application security controls
- [`smallforce app access`](/docs/cli/commands/app/access): Manage platform-level public, password, Google, or SSO access

## Complete command help

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

Initialize, deploy, inspect, and protect a generated application

Options:
  -h, --help             display help for command

Commands:
  init [options]         Create an application record and write smallforce.json
  deploy [options]       Build, upload, publish, and activate an immutable Preview release
  status [options]       Read live application, environment, and release state
  delete [options]       Disable and remove an application from SmallForce
  inspect [options]      Inspect the live app release, database, and files
  db                     Inspect or query the application's implicit SQLite database
  files                  Inspect files created or uploaded while the app is running
  logs [options]         Read application and runtime logs
  events [options]       Read custom OpenTelemetry application events
  analytics [options]    Read human visitor and crawler analytics
  diagnostics [options]  Read request failures, rate limits, and runtime diagnostics
  metrics [options]      Read request, latency, error, and response-size metrics
  traces                 List and inspect OpenTelemetry request traces
  env                    Manage stable Preview, Production, and custom environment targets
  var                    Manage plaintext variables for one explicit environment
  secret                 Manage write-only secrets for one explicit environment
  release                Inspect immutable application releases
  security               Read or replace optional application security controls
  access                 Manage platform-level public, password, Google, or SSO access
  help [command]         display help for command
```

## Related reference

- [`smallforce`](/docs/cli/commands): 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.