JavaScript SDK for Improv Wi-Fi over BLE

Installation

You can use the JavaScript SDK by adding the following HTML to your website:

<script type="module" src="https://www.improv-wifi.com/sdk-js/launch-button.js"></script>

If you are using a bundler and JavaScript package manager, you can install the SDK via NPM:

npm install --save improv-wifi-sdk

And then import it in your code:

import 'improv-wifi-sdk';

Usage

Add the following to your website to show a button to start the provisioning process:

<improv-wifi-launch-button></improv-wifi-launch-button>

A warning message will be rendered if the browser does not support WebBluetooth.

Attributes

The following attributes are automatically added to <improv-wifi-launch-button> and can be used for styling:

Attribute	Description
`supported`	Added if this browser is supported
`unsupported`	Added if this browser is not supported

Slots

It is possible to customize the button and the message. You do this by putting your elements inside the <improv-wifi-launch-button> element and adding the appropriate slot attribute. Use activate to replace the activation button and unsupported to replace the unsupported message:

<improv-wifi-launch-button>
  <button slot='activate'>Start provisioning!</button>
  <span slot='unsupported'>Your browser does not support provisioning.</span>
</improv-wifi-launch-button>

Events

When the state of provisioning changes, a state-changed event is fired.

A state-changed event contains the following information:

Field	Description
state	The current state (`CONNECTING`, `AUTHORIZATION_REQUIRED`, `AUTHORIZED`, `PROVISIONING`, `PROVISIONED`, `ERROR`, `UNKNOWN`)

Browser Support

This SDK requires a browser with support for WebBluetooth. Currently this is supported by Google Chrome, Microsoft Edge and other browsers based on the Blink engine.

No iOS devices are supported.