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

# White-label Apps

> Ship a branded web + mobile app for your device line with the app-starter.

The **app-starter** is a white-label, user-facing IoT app boilerplate. Clone it,
edit one config file, and ship a working web + mobile app for your devices —
wired to the Hyperwisor manufacturer API and realtime relay.

## What it is

* **Web + native from one codebase** — Vite + React 18 + TypeScript, with
  Capacitor for Android and iOS
* **Boots in mock mode** — runs with fake data until you add real API keys, so
  you can explore before connecting anything
* **Single config file** — `app.config.ts` for branding, theme, and mode
* **AI-generated screens** — bespoke, hand-quality device UIs generated by an AI
  agent, not a generic widget grid

<Note>
  The app-starter is **not** the canvas dashboard builder. It produces real,
  editable React screens you own — purpose-built per product. That bespoke quality
  is the point.
</Note>

## Mock mode vs live

| Mode               | Behavior                                                               |
| ------------------ | ---------------------------------------------------------------------- |
| **Mock** (default) | Signed in as a demo user with pre-loaded fake devices. No keys needed. |
| **Live**           | Real auth and device APIs once you add your manufacturer API keys.     |

## Single vs multi-product

| Mode                      | App is for…                                      |
| ------------------------- | ------------------------------------------------ |
| `single-product`          | One device line. QR scan rejects other products. |
| `multi-product` (default) | A catalog. QR scan accepts any of your products. |

<CardGroup cols={2}>
  <Card title="Quickstart" icon="bolt" href="/apps/quickstart">
    Clone to running app in five minutes.
  </Card>

  <Card title="AI-generated screens" icon="robot" href="/apps/ai-screens">
    Generate bespoke device UIs.
  </Card>

  <Card title="Modes" icon="toggle-on" href="/apps/modes">
    Single vs multi-product.
  </Card>

  <Card title="Security" icon="shield" href="/apps/security">
    Protect your secret key. Read before going live.
  </Card>
</CardGroup>