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

# Lesson 5 — Publish & Onboard

> Make your product available and onboard a device as a user.

**Goal:** take the product you've built and get a device into a user's account.

## 1. Publish (optional — for the marketplace)

To sell or share the product, publish it as a template from the product's
**Marketplace Template** tab — pick a [listing type and license](/monetization/licensing),
set pricing, and publish. Buyers clone it into their account with one click. See
[Marketplace](/monetization/marketplace).

## 2. Onboard a device

A user adds a device by **scanning its QR code**. The flow:

<Steps>
  <Step title="Scan the QR">
    The app reads the code and resolves the product info
    (`POST /onboarding/scan-qr` with `{ qr_data }`).
  </Step>

  <Step title="Name and register">
    The user names the device; it's registered to their account
    (`POST /onboarding/device` with the user, product, and device identifiers).
  </Step>

  <Step title="It appears">
    The device shows up in the user's dashboard, bound to the manufacturer's UI.
  </Step>
</Steps>

Firmware can also drive onboarding directly with
`onboardDevice(productId, userId, deviceName, deviceIdentifier)` — see the
[API reference](/firmware/arduino/api-reference#onboarding).

## You've completed the loop

Across five lessons you:

1. Brought a device online
2. Pushed a value to a widget
3. Controlled hardware from a widget
4. Stored readings in the database
5. Published the product and onboarded a device

That's the full Hyperwisor cycle — from firmware to a user's hands.

<CardGroup cols={2}>
  <Card title="Go further: custom dashboards" icon="grid-2" href="/custom-dashboard/overview">
    Build multi-device dashboards.
  </Card>

  <Card title="Monetize" icon="hand-holding-dollar" href="/monetization/overview">
    Marketplace, licensing, and revenue.
  </Card>
</CardGroup>