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

# Create a Live App

Describe the app you want and let WisdomAI build it. Refine the result with chat, annotations, and direct text edits.

## Before you begin

Make sure you have the following:

* A role that can create apps. Explorer roles and above qualify. See the [Access Management](/manage-account/access-management) page for more details.
* An app draws its data from your domains. Domains with well-defined metrics, synonyms, and knowledge produce noticeably better apps.

## Create an app

Describe the app you need and WisdomAI builds it in the background.

1. Open Apps. Click **Apps** in the sidebar. Apps and dashboards share this list.
2. Click **New App**. A composer opens and asks you to describe the app.
   <img src="https://mintcdn.com/wisdomai/UPOaVBWR2hNMl9Qp/images/new-live-app.png?fit=max&auto=format&n=UPOaVBWR2hNMl9Qp&q=85&s=2cc921bd3275ae179b789317c1b11b9a" alt="Live Apps tab selected in the dashboards list with the New App button highlighted top right" width="1878" height="956" data-path="images/new-live-app.png" />
3. Describe the app. Say who it is for, what job it does, and the metrics, breakdowns, and views you care about.
4. Let it build. WisdomAI answers the data questions first, then generates and validates the app. You can leave the page; generation continues on the server, and the app picks up where it left off when you come back.
   <img src="https://mintcdn.com/wisdomai/-qKL6AJyxoqn3qNW/images/build-live-app.png?fit=max&auto=format&n=-qKL6AJyxoqn3qNW&q=85&s=736a9ae6fcf333bdcf617b0cfe55b06c" alt="Ask WisdomAI panel showing the build prompt and reasoning, with a Building your app progress card" width="1778" height="943" data-path="images/build-live-app.png" />
5. Review the result. Check the numbers, then refine anything you want changed.
   <img src="https://mintcdn.com/wisdomai/P5FotFHrU5bDBKju/images/live-app-finished.png?fit=max&auto=format&n=P5FotFHrU5bDBKju&q=85&s=5e024234aef16d8aad1d543ff0bc73ec" alt="Finished 2025 Sales Summary app with KPI cards, filters, a revenue heatmap, and a chat summary of included views" width="1788" height="958" data-path="images/live-app-finished.png" />
   <Note>
     There is no notification when generation finishes. Return to the app to see the result.
   </Note>

## Write a prompt that works

A focused, specific prompt produces a more useful app than a generic one.

* Name the audience and the job. "A pipeline review for the weekly sales leadership meeting" produces a more focused app than "sales dashboard".
* Use the metric names and terms your domain defines.
* Say how the app should be organized if you have an opinion, such as sections, tabs, or a hero metric at the top.
* Attach a reference image if you have a target look. WisdomAI uses attached images as visual reference during generation.

## Refine the app

Editors have three ways to change an app.

* Chat. Open **Ask WisdomAI** and describe the change. Use chat for anything broad, like adding a section or changing what a chart shows.
  <img src="https://mintcdn.com/wisdomai/-qKL6AJyxoqn3qNW/images/ask-live-app.png?fit=max&auto=format&n=-qKL6AJyxoqn3qNW&q=85&s=9e27a7b9243a3c776c2a1e61beaf7fa2" alt="Ask WisdomAI chat panel listing the KPI cards, heatmap, filters, and table included in the generated app" width="1773" height="937" data-path="images/ask-live-app.png" />
* Annotate. Click **Annotate** in the toolbar (or press **C**), click an element, and leave an instruction for that element only. Use it for targeted fixes, like making one KPI the hero metric, without touching the rest of the app.
  <img src="https://mintcdn.com/wisdomai/-qKL6AJyxoqn3qNW/images/anotate-step-one.png?fit=max&auto=format&n=-qKL6AJyxoqn3qNW&q=85&s=831be6bb8ea8617388a5a692a1d2dbdc" alt="Annotate tool selected in the app toolbar, shown as a highlighted pencil icon" width="1149" height="954" data-path="images/anotate-step-one.png" />
  <img src="https://mintcdn.com/wisdomai/-qKL6AJyxoqn3qNW/images/anotate-step-two.png?fit=max&auto=format&n=-qKL6AJyxoqn3qNW&q=85&s=85ea5cc3013d3ec12e8d7b40765b62a8" alt="Instruction box open on the Closed Won Revenue KPI card reading Total revenue in 2025 across different industry sectors" width="1148" height="958" data-path="images/anotate-step-two.png" />
  <Note>
    Viewers can annotate and chat too. For them it opens a scoped conversation about the app; changing the app itself stays with editors.
  </Note>
* Edit text. Click **Edit text** (or press **T**) to change titles and labels in place, then click **Save edits**. Text that comes from your data is marked **From app data** and is changed through chat or annotations instead.

  <img src="https://mintcdn.com/wisdomai/EyUYF_Hh7gmbQSbw/images/edit-text-live-apps.png?fit=max&auto=format&n=EyUYF_Hh7gmbQSbw&q=85&s=0aff9fbff706548d4ed78d260a8c2eae" alt="Sales detail table title being renamed inline to Sales detail Updated Version with a confirm checkmark" width="1144" height="956" data-path="images/edit-text-live-apps.png" />

  <Warning>
    Changes apply to the app everyone sees. Live Apps have no separate draft version, so refine an app before you share it widely, or duplicate it to experiment.
  </Warning>

If an app fails to render after a change, editors see **Fix with AI**, which sends the failure details to chat and asks WisdomAI to repair the app. You can also restore an earlier state at any time with **Version history** in the app menu.

## Switch views

The control at the top of an app has up to three views.

* **Preview**: Shows the app itself.
  <img src="https://mintcdn.com/wisdomai/UPOaVBWR2hNMl9Qp/images/preview-live-apps.png?fit=max&auto=format&n=UPOaVBWR2hNMl9Qp&q=85&s=2ad29f7eebad7dbff86b9cf611ca2e64" alt="Preview view of the 2025 Sales Summary app with KPI cards, filters, and a revenue heatmap" width="1770" height="948" data-path="images/preview-live-apps.png" />
* **Code**: Shows the generated React source. Every app is real, inspectable code.
  <img src="https://mintcdn.com/wisdomai/EyUYF_Hh7gmbQSbw/images/code-live-apps.png?fit=max&auto=format&n=EyUYF_Hh7gmbQSbw&q=85&s=d92c907d99a3bf583a2736e17fb29da2" alt="Code view listing GeneratedApp.jsx and generated files, with the React source open in the editor" width="1776" height="944" data-path="images/code-live-apps.png" />
* **Sources**: Shows the widgets that serve the app's data, laid out as plain tiles.
  <img src="https://mintcdn.com/wisdomai/sRUv2NZE44a9Fse9/images/sources-live-apps.png?fit=max&auto=format&n=sRUv2NZE44a9Fse9&q=85&s=12265b1bc2d6e31c6a8880eaf2bd3a33" alt="Sources view showing three plain tiles: a revenue heatmap, a sales summary table, and a KPI tile" width="1778" height="946" data-path="images/sources-live-apps.png" />

## Rename, organize, duplicate, or delete

Manage an app's name, location, and lifecycle from its menu.

* Rename an app by clicking its title in the builder and typing.
* Apps sit in the same folders as dashboards. Use **Move** in the app menu to file one, and star it to pin it to your Starred view.
* **Duplicate** in the app menu creates a copy you own.
* **Delete** removes the app. This cannot be undone.

## Migrate a dashboard

Turn an existing dashboard into a Live App from the dashboard itself.

1. Open the dashboard's menu and choose **Migrate to Live App**.
   <img src="https://mintcdn.com/wisdomai/UPOaVBWR2hNMl9Qp/images/migrate-dash-live-app.png?fit=max&auto=format&n=UPOaVBWR2hNMl9Qp&q=85&s=741d8ea3fbdb282e7c797b072b24af51" alt="Dashboard menu open with Migrate to Live App highlighted above Duplicate, Rename, and Delete" width="1792" height="948" data-path="images/migrate-dash-live-app.png" />
2. Review the new app. WisdomAI copies the dashboard's widgets and generates an interface over them. The original dashboard is not changed.
   <img src="https://mintcdn.com/wisdomai/EyUYF_Hh7gmbQSbw/images/dash-migrated-live-app.png?fit=max&auto=format&n=EyUYF_Hh7gmbQSbw&q=85&s=d1500bbf349be174e16d7192f4d22dc6" alt="Migrated Live App with KPI cards, a quarter-range slider, and a trend chart, plus a chat list of included views" width="1792" height="938" data-path="images/dash-migrated-live-app.png" />
   <Note>
     Two conditions apply. Every widget on the dashboard must belong to the same domain, and dashboards with global filters cannot be migrated yet. Remove global filters first if you want to migrate; support for migrating filtered dashboards arrives with parameterized filters, which are coming soon.
   </Note>

## Next steps

<CardGroup cols={2}>
  <Card title="See the Data Behind a Live App" icon="database" href="/live-apps/data-and-trust">
    Inspect widgets, read the SQL, and manage freshness.
  </Card>

  <Card title="Share a Live App and Manage Access" icon="unlock" href="/live-apps/share-and-access">
    Roles, organization-wide sharing, and exports.
  </Card>
</CardGroup>
