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

# What is a live app?

> A dashboard that Alex builds once and that then keeps itself up to date, at a link that never changes.

> [!NOTE]
>
> **In short:** A live app is a dashboard that Alex builds once. After that, it keeps itself up to date. You and your team always open the same link and see the latest figures. Buttons and fields are named exactly as they appear on screen, for example **Ask for a change**.

## What a live app is

A **one-off report** ends with its delivery. A **live app**, by contrast, is a dashboard that [Alex](https://docs.serviceplan-agents.com/en/coworkers/alex.md) builds once and that then keeps itself up to date. It has three defining features:

* **A fixed link** that never changes.
* **An optional password**, so that only the people you share it with can open the dashboard.
* **Data areas:** Each series of figures forms its own data area, such as "Prices per week" or "Electricity consumption by region". For each area, it is defined how often new data arrives (**cadence**) and which coworker **delivers** it. See [Data areas and refreshes](https://docs.serviceplan-agents.com/en/live-apps/data-feeds.md).

A refresh never changes the design of the dashboard. Only the figures change.

## Who does what

> [card] You
>
> You describe what the dashboard is for. You review the preview and decide when it goes live.

> [card] Alex
>
> Alex builds the dashboard and implements every change.

> [card] Hannah
>
> Hannah researches figures on markets, politics, social media and polls.

Other coworkers deliver data from their own field, for example customer, project or campaign figures.

## The process at a glance

```mermaid theme={"dark"}
%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#FFF5F5','primaryBorderColor':'#FF4B4F','primaryTextColor':'#141414','lineColor':'#FF4B4F','tertiaryColor':'#ffffff','fontSize':'14px'}}}%%
flowchart TD
    A["1 · You make a request<br/>new dashboard, change or copy"] --> B["2 · Alex builds a preview"]
    B --> C["3 · You decide"]
    C -->|"Not right yet"| B
    C -->|"Approve and put live"| D{"Does every section<br/>show its data?"}
    D -->|"No, reason is shown"| B
    D -->|"Yes"| E["4 · Live<br/>link and password"]
    E --> F["5 · In operation<br/>refreshes, proposals, alerts"]
    F -->|"Request a change"| B
```

1. **You make a request:** a new dashboard, a change to an existing one, or a copy. See [Requesting a live app](https://docs.serviceplan-agents.com/en/live-apps/ordering.md).
2. **Alex builds a preview.** No one outside your workspace can see it yet. If real data is missing, the preview shows sample figures and clearly points out the missing data.
3. **You decide.**
   * Not right yet? Give a reason for rejecting it and start a revision.
   * Everything fits? Click **Approve and put live**. The Console first checks whether every section actually displays its data. If the check fails, nothing goes live. The Console shows you the reason. See [Preview and going live](https://docs.serviceplan-agents.com/en/live-apps/preview-and-go-live.md).
4. **The dashboard is live.** Your team receives the fixed link and the password. From now on, every data area refreshes itself automatically according to its chosen cadence.
5. **In operation.**
   * Coworkers suggest how data collection could be improved. You can accept or reject these proposals. See [Rules, method and lists](https://docs.serviceplan-agents.com/en/live-apps/feed-guides.md).
   * If something goes wrong, you receive an alert with a button to fix it. See [When something goes wrong](https://docs.serviceplan-agents.com/en/live-apps/disruption-mails.md).
   * Want to change something? Request a change at any time. The process then starts again at step 2.

## Where to find your live apps

Open the [Console](https://console.serviceplan-agents.com) and go to **Builds**. Every live app in your workspace is listed there with a status badge:

| Badge | Meaning |
| - | - |
| **Live** | The dashboard is online and refreshes on its cadence. |
| **Expiring soon** | The run time ends soon. Every data refresh extends it. You can extend it yourself with **Extend by 90 days**. |
| **Grace period** | The run time has ended. The dashboard stays online for a short while. |
| **Paused** or **Offline** | The dashboard is not available right now. Nothing is deleted. Use **Bring this dashboard back** on its page to restore it. |

### A dashboard's page

Each dashboard is managed via its own page. It has four tabs:

* **Overview:** **Needs your attention**, the data areas under **Data** and the costs under **What it costs**.
* **Setup:** the rules, the method and the lists, plus open proposals.
* **Access:** the link, the password, the person responsible (owner) and the project.
* **History:** jobs, versions, runs and costs, data refreshes and alerts. The newest come first.

At the top of the page are **Open dashboard** and **Ask for a change**. You will find all other functions in the **…** menu, starting with **Copy dashboard**.

> [!NOTE]
>
> **Screenshot needed:** the Builds page with a few live apps and their badges.

## What you can do next

> [card] [Your first live app](https://docs.serviceplan-agents.com/en/live-apps/first-live-app.md)
>
> The whole journey as an example, step by step.

> [card] [Requesting a live app](https://docs.serviceplan-agents.com/en/live-apps/ordering.md)
>
> A new dashboard, a change or a copy.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.