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

# Versioning

> Create immutable version snapshots of your app for distribution and deployment

Apps are versioned through the Synthetiq platform. Each version is an immutable snapshot that can be installed, shared, or deployed.

## Publishing a version

```bash theme={null}
synthetiq app push my-app --message "Added dashboard page"
```

This builds, packages, and publishes a new version to the Synthetiq registry.

## Version history

List all published versions:

```bash theme={null}
synthetiq app versions my-app
```

## Active version

Set which version is current in the app store:

```bash theme={null}
synthetiq app set-active my-app --version 2024.06.10-153042
```

## Installing a specific version

```bash theme={null}
synthetiq store install my-app --version 2024.06.08-091530
```

By default, `store install` installs the active version. Use `--version` to install a specific version, such as when rolling back to a previous release.

See the [CLI app commands](/docs/platform-docs/cli/apps) and [Platform API versions docs](/docs/platform-docs/platform-api/versions) for details.