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

# Build a Database App

> Promote a workspace table into an app with its own managed database.

This walkthrough turns a [table](/concepts/tables) into a [Database App](/concepts/database-apps). Full flags for each command are in the generated [`app`](/cli/workspace) and [`table`](/cli/workspace) reference.

## 1. Start from a table

Create or identify the table that holds your data:

```bash theme={null}
kylon workspace table list --scope-workspace <workspace_id>
```

## 2. Inspect the upgrade

Before promoting, review what the app will look like:

```bash theme={null}
kylon workspace table upgrade-plan <table_id>
```

The plan describes the database and contract the App will be created with.

## 3. Promote the table

```bash theme={null}
kylon workspace table upgrade-to-app <table_id>
```

This creates the App with its own managed database.

## 4. Operate the App

Confirm it exists and explore its data:

```bash theme={null}
kylon workspace app list
kylon workspace app show <app_id>
kylon workspace app data-view <app_id> ...
```

From here the App is a first-class surface — see [`app`](/cli/workspace) for configuration and data-view options.