> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.instabase.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.instabase.com/_mcp/server.

# Creating or versioning apps

> Package your project into a reusable app version so it can be used and deployed.

After you've built and refined your automation project, the next step is packaging it into a reusable automation app. Creating an app transforms your project into a shareable, deployable solution that can be run consistently across different environments and shared with other users in your organization.

## Creating an app

Creating an app lets you reuse, automate, and share your project functionality.

1. From your automation project, hover over the **App** workflow selector, then click **Create app**.

2. Confirm the name of your app and specify optional details, then click **Next**.

   * **Name** -- By default, apps are assigned the same name as the corresponding automation project. You can change app name as needed when you create the app, but it can't be changed later.

   * **Description** -- Enter a description for the app to help users understand its purpose.

   * **App customization**  -- Allows users with app access to copy and modify its source project. Users can't publish a new version of the existing app, but can create a new app from their copy.

   * **App icon** -- Upload an icon to represent your app. Icons can be up to 2 MB.

   * **Sample files** (standard apps) -- Upload up to three representative files so users can preview app functionality.

   * **Sample packet** (apps with cross-class fields) -- Upload one representative packet containing multiple related document types so users can preview app functionality.

3. Confirm version details, then click **Create app**.

   * **Version** -- By default, the first version of your app is numbered 0.0.1.

   * **AI runtime updates**  -- Select whether the app adopts the latest [AI runtime version](/automate/version-control#ai-runtime-versions) automatically as soon as it's released, or when the current version expires, which allows time for testing and manual deployment.

   * **Release notes** -- Describe what changed in this app version.

   * **Version visibility** -- Select whether this app version is private or shared. For more details, see [Sharing apps](/automate/app-use#sharing-apps).

   Your app is created and published to the Hub.

## Adding an app version

When you make changes to an app's underlying project, such as modifying settings, fields, or validations, you can create a new version of the app that includes your changes.

1. From your automation project, hover over the **App** workflow selector, then click **Add version**.

2. Confirm version details, then click **Add version**.

   * **Version** -- Select whether this version of your app is a major (3.0.0), minor (2.1.0), or patch (2.0.1) increment.

   * **AI runtime updates**  -- Select whether the app adopts the latest [AI runtime version](/automate/version-control#ai-runtime-versions) automatically as soon as it's released, or when the current version expires, which allows time for testing and manual deployment.

   * **Release notes** -- Describe what changed in this app version.

   * **Version visibility** -- Select whether this app version is private or shared. For more details, see [Sharing apps](/automate/app-use#sharing-apps).

   Your app version is created and added to the app's **Version history** page.