# Create an App Catalog

An **App Catalog** defines which workloads make up your application — it's the blueprint Lapdev uses to create development environments.

This guide walks you through creating an App Catalog from your connected cluster.

> To understand why App Catalogs exist and how they fit into Lapdev, read [**App Catalog**](https://docs.lap.dev/core-concepts/app-catalog) first.

### Prerequisites

Before creating an App Catalog, make sure:

* You've connected at least one **Kubernetes cluster** to Lapdev.
* The cluster you'll read workloads from shows as **Active** in the Lapdev dashboard.
* The cluster contains the workloads you want to include (e.g. your production or staging workloads).

> Don't have a cluster connected yet? See [**Connect Your Kubernetes Cluster**](https://docs.lap.dev/how-to-guides/connect-your-kubernetes-cluster).

> 💡 The same cluster can be used later for both reading workloads **and** deploying environments.

### Open the Cluster in the Dashboard

1. Go to <https://app.lap.dev>.
2. Navigate to the **Clusters** tab.
3. Click the cluster you want to use as the **source**.

### Select Workloads

Once inside the cluster details page:

1. Lapdev lists all **workloads** (Deployments, StatefulSets, DaemonSets, etc.) discovered in the cluster.
2. You can:
   * Filter workloads by **Namespace** or **Workload Type**.
   * Optionally check **Show System Workloads** to include system components.
3. Select the workloads that make up your app.

<figure><img src="https://3284468452-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnCHF64WOwSvzfUL4cG6Q%2Fuploads%2Fgit-blob-5d4bc48853617f899c8c1f3e4fe88d53ebcc2fc3%2FScreenshot%202025-11-19%20at%2020-27-19%20Lapdev%20Dashboard.png?alt=media" alt=""><figcaption></figcaption></figure>

### Create the App Catalog

1. After selecting workloads, click **Create App Catalog**.
2. In the dialog:
   * Enter a **Name** for the catalog (e.g. `checkout-service`, `internal-tools`).
   * Optionally add a **Description**.
   * Review the list of selected workloads.
3. Click **Create**.

<figure><img src="https://3284468452-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnCHF64WOwSvzfUL4cG6Q%2Fuploads%2Fgit-blob-70c5b4e1fbc180fd04934d7aa5afd35ceb8c9f69%2FScreenshot%202025-11-19%20at%2020-30-01%20Lapdev%20Dashboard.png?alt=media" alt=""><figcaption></figcaption></figure>

Lapdev will create the catalog and register it in the **App Catalogs** section of your dashboard.

> 💡 Don’t worry if you missed something — you can edit the catalog later to add or remove workloads.

### Verify Your App Catalog

1. Go to the **App Catalogs** tab in the dashboard.
2. You’ll see your newly created catalog listed with:
   * The **name** and **description**
   * The **number of workloads** included
   * The **source cluster**

Click a catalog name to view its details.

*Example screenshot:*

### Next Steps

Once your App Catalog is ready, you can:

* Create a [Lapdev Environment](https://docs.lap.dev/how-to-guides/create-lapdev-environment) from it
* Learn about [Environment types](https://docs.lap.dev/core-concepts/environment)
* Understand [Cluster roles](https://docs.lap.dev/core-concepts/cluster) for multi-cluster setups