App Quickstart - Hyperwisor

1. Clone and run

hyperwisor-app-starter

The boilerplate on GitHub.

git clone https://github.com/nikolaindustry/hyperwisor-app-starter.git my-brand-app
cd my-brand-app
npm install
npm run dev

Open the dev server. You’re signed in as a demo user with two pre-loaded fake devices (mock mode). Tap Add device → Try a demo QR to test the onboarding flow without hardware.

2. Go live

Get your API key (mk_…) and secret key (msk_…) from the Hyperwisor manufacturer dashboard.
Copy .env.example to .env.local and fill in:
VITE_HW_API_KEY=mk_... VITE_HW_SECRET_KEY=msk_...
.env.local is git-ignored — your keys never get committed.
Restart npm run dev. The mock banner disappears; auth and device APIs now hit the real backend.

The msk_ secret key must never ship in a production mobile binary. See Security before you build for release.

3. Build a product UI

You don’t lay out device screens by hand — an AI agent generates them:

npm run inspect                 # list your products
npm run generate <productId>    # AI builds the screen + registers it
npm run dev

See AI-Generated Screens for both generation paths.

Choose a mode

Single vs multi-product.

Brand it

Colors, logo, theme.

​1. Clone and run

hyperwisor-app-starter

​2. Go live

​3. Build a product UI

Choose a mode

Brand it

1. Clone and run

2. Go live

3. Build a product UI