> ## 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.

# Introduction

> What Hyperwisor is and the three roles it serves.

Hyperwisor is an end-to-end IoT platform. A **manufacturer** designs a product —
its commands, database, dashboard, and firmware — once. A **user** onboards a
physical device and controls it from a ready-made dashboard. An **integrator**
composes custom dashboards across many devices. Anyone can sell their product as
a template in the marketplace.

## The three roles

<CardGroup cols={3}>
  <Card title="Manufacturer" icon="wrench">
    Builds a product: defines commands, designs a dashboard, flashes firmware
    with the Hyperwisor SDK, and publishes to the marketplace.
  </Card>

  <Card title="User" icon="mobile">
    Onboards a device by scanning its QR code, then monitors and controls it
    from the manufacturer's dashboard.
  </Card>

  <Card title="Integrator" icon="grid-2">
    Builds custom multi-device dashboards with 50+ drag-and-drop widgets, or a
    bespoke branded app with the app-starter.
  </Card>
</CardGroup>

## What you build with

Hyperwisor gives you several surfaces depending on your role:

<CardGroup cols={2}>
  <Card title="Firmware SDK" icon="microchip" href="/firmware/overview">
    Arduino and ESP-IDF libraries for ESP32-class devices. They handle Wi-Fi
    provisioning, realtime communication, OTA, and dashboard widget updates.
  </Card>

  <Card title="Dashboard Designer" icon="table-cells" href="/dashboard/overview">
    A no-code canvas with 50+ widgets. Bind a widget to device data and it
    updates live; add a control and it sends a command back.
  </Card>

  <Card title="Script API" icon="code" href="/script/overview">
    JavaScript logic on a dashboard — react to widget changes, talk over the
    realtime channel, query the database.
  </Card>

  <Card title="White-label Apps" icon="mobile-screen" href="/apps/overview">
    The app-starter boilerplate ships a branded web + mobile app for your
    device line, with AI-generated bespoke screens.
  </Card>
</CardGroup>

## Where to start

<CardGroup cols={2}>
  <Card title="How it works" icon="diagram-project" href="/learn/how-it-works">
    The one idea that ties firmware and dashboards together.
  </Card>

  <Card title="Core concepts" icon="cubes" href="/learn/concepts">
    Product vs. device vs. user vs. dashboard.
  </Card>

  <Card title="Lessons" icon="graduation-cap" href="/learn/lessons/overview">
    A guided path from first device to published product.
  </Card>

  <Card title="Firmware SDK" icon="microchip" href="/firmware/overview">
    Pick Arduino or ESP-IDF and flash your first device.
  </Card>
</CardGroup>