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

# Migrate to 1 0

# Migrate to 1.0

> Upgrade from deprecated compatibility commands to the 1.0 command surface

Version 1.0 removes the long-standing deprecated command shims and old alias
paths. If you have older shell scripts, CI jobs, or internal runbooks, update
them to the canonical 1.0 commands on this page before you cut over.

## What changed

The 1.0 release keeps the current command families, but removes older
compatibility verbs and alias trees that had been kept around during the
transition to the clearer `view` / `edit` / `list` command style.

Use `asc --help` and `asc <command> --help` against the 1.0 binary when
updating automation. The CLI is the source of truth.

## Common migrations

* Deprecated `asc apps create` -> `asc web apps create`
* Deprecated `asc submit preflight` -> `asc validate`
* Deprecated `asc submit create` -> `asc publish appstore --submit --confirm`
* Deprecated `asc release run` -> `asc publish appstore --submit --confirm`
* Deprecated `asc apps get` -> `asc apps view`
* Deprecated `asc age-rating set` -> `asc age-rating edit`
* Deprecated `asc pricing availability set` -> `asc pricing availability edit`
* Deprecated `asc versions get` -> `asc versions view`

## Release workflow migration

Use these replacements for App Store shipping flows:

Deprecated command: `asc release run --app "APP_ID" --version "1.0.0" --build "BUILD_ID" --metadata-dir "./metadata/version/1.0.0" --confirm`

Canonical replacements:

```bash theme={null} theme={null}
asc publish appstore --app "APP_ID" --ipa "./MyApp.ipa" --version "1.0.0" --submit --confirm
asc release stage --app "APP_ID" --version "1.0.0" --build "BUILD_ID" --metadata-dir "./metadata/version/1.0.0" --confirm
```

Use `publish appstore` when you want an end-to-end ship flow that uploads the
build and submits it. Use `release stage` when you already have the build in App
Store Connect and want to prepare the version without creating the review
submission yet.

## Submission workflow migration

Deprecated readiness check: `asc submit preflight --app "APP_ID" --version "1.0.0"`

Deprecated final submission step: `asc submit create --app "APP_ID" --version "1.0.0" --build "BUILD_ID" --confirm`

Canonical replacements:

```bash theme={null} theme={null}
asc validate --app "APP_ID" --version "1.0.0"
asc publish appstore --app "APP_ID" --ipa "./MyApp.ipa" --version "1.0.0" --submit --confirm
```

For post-submit lifecycle work, keep using:

```bash theme={null} theme={null}
asc submit status --version-id "VERSION_ID"
asc submit cancel --version-id "VERSION_ID" --confirm
```

## App creation migration

App creation is now an explicit web-session workflow:

```bash theme={null} theme={null}
asc web apps create --name "My App" --bundle-id "com.example.app" --sku "MYAPP123" --apple-id "user@example.com"
```

This flow is unofficial and uses Apple web-session endpoints. It is separate
from the API-key driven `apps` family on purpose.

## Updating `get` / `set` scripts

Several older command families used `get` and `set` verbs. In 1.0, migrate
those scripts to the canonical verbs shown in help output:

* `get` becomes `view`
* `set` becomes `edit`
* collection-oriented reads stay `list`

Examples:

```bash theme={null} theme={null}
asc apps view --id "APP_ID"
asc categories set --app "APP_ID" --primary GAMES
asc age-rating edit --app "APP_ID" --all-none
asc pricing availability edit --app "APP_ID" --territory "USA,GBR,IND" --available true
```

## Upgrade checklist

1. Search your repo for removed commands such as `release run`, `submit preflight`, `submit create`, and `apps create`.
2. Replace `get` and `set` aliases with `view` and `edit` where the 1.0 help output shows those canonical verbs.
3. Re-run your CI scripts with the 1.0 binary and verify exit codes, stderr handling, and structured output parsing.
4. Update internal runbooks and onboarding docs to point at the canonical command pages.

## Related docs

* [Command Reference Overview](/commands/overview)
* [Publish](/commands/publish)
* [Release](/commands/release)
* [Submit](/commands/submit)
* [Web](/commands/web)