> For the complete documentation index, see [llms.txt](https://docs.tryterra.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tryterra.co/developer-tools/example-apps/example-apps.md).

# Overview

Complete apps built on Terra. Download one with the Terra CLI.

Start from a working app instead of a blank project. Each one is a complete Terra integration.

## Quickstart

Download an example with the Terra CLI, then follow its setup guide. The commands below use the Unified API app.

{% stepper %}
{% step %}

### Install the Terra CLI

Install with npm. This option requires Node.js 18 or later.

```bash
npm install -g @tryterra/cli
```

See [Installation](/developer-tools/terra-cli/installation.md) for other install options.
{% endstep %}

{% step %}

### Choose an app

List the available examples, or browse the [app guides below](#explore-the-apps).

```bash
terra examples list
```

{% endstep %}

{% step %}

### Download the app

Download the Unified API example into a new `my-app` directory:

```bash
terra examples clone unified-api-web-app my-app
```

To download a different app, replace `unified-api-web-app` with its name from the list. Choose a destination that does not exist yet, inside an existing parent directory.

{% hint style="info" %}
Downloading requires a network connection, but no Terra login or Git.
{% endhint %}
{% endstep %}

{% step %}

### Set up and run the app

Open the downloaded directory and install its dependencies:

```bash
cd my-app
npm install
```

Follow the app's README to configure credentials and run it. For this example, continue with the [Unified API setup guide](/developer-tools/example-apps/terra-basecamp.md#run-it-yourself). Each app's guide lists its required tools and accounts.
{% endstep %}
{% endstepper %}

<details>

<summary>How downloads work</summary>

* `clone` returns the downloaded app's path and next steps.
* If you omit `my-app`, the directory defaults to the example name.
* The CLI fetches the current catalog, so new examples appear without updating it.
* Downloading does not require Node.js if you installed the CLI without npm. Running an app requires the tools listed in its guide.

</details>

## Explore the apps

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Unified API Example</strong></td><td>Terra Basecamp</td><td>Wearable connections, webhook ingestion, deduplication, a dashboard, and an AI assistant.</td><td><a href="/developer-tools/example-apps/terra-basecamp.md">Unified API Example</a></td></tr><tr><td><strong>Streaming Mobile Example</strong></td><td>Terra Grip</td><td>Pair a wearable in React Native and stream live biometrics to Terra.</td><td><a href="/developer-tools/example-apps/terra-grip.md">Streaming Mobile Example</a></td></tr><tr><td><strong>Streaming Web Example</strong></td><td>Terra Pulse</td><td>Open a WebSocket from a React web app and render the stream live.</td><td><a href="/developer-tools/example-apps/terra-pulse.md">Streaming Web Example</a></td></tr><tr><td><strong>Lab Reports Example</strong></td><td>Terra Panel</td><td>Upload a lab report PDF and read standardized biomarkers against a patient's wearable history.</td><td><a href="/developer-tools/example-apps/terra-panel.md">Lab Reports Example</a></td></tr><tr><td><strong>Vantage Example</strong></td><td>Terra Dispatch</td><td>Order test kits, track fulfilment, and deliver FHIR results.</td><td><a href="/developer-tools/example-apps/terra-dispatch.md">Vantage Example</a></td></tr></tbody></table>

{% hint style="info" %}
The Lab Reports and Vantage apps run locally in demo mode with no credentials, so you can read the code against a working app before setting anything up.
{% endhint %}

<a href="https://github.com/tryterra/terra-examples" class="button secondary" data-icon="github">Browse terra-examples</a>