Skip to content

Examples

Onboarding step

An onboarding step with a progress readout, workspace basics, a theme toggle group and Back and Continue spread across the foot.

Preview

Set up your workspace

Everything here can change later in Settings.

HTML
<bs:bsui-stack direction="column" gap="4" align="stretch">
  <bs:bsui-progress value="2" max="4" label="Step 2 of 4" />
  <bs:bsui-stack direction="column" gap="1">
    <bs:bsui-text content="Set up your workspace" variant="title" tag="h2" />
    <bs:bsui-text content="Everything here can change later in Settings." variant="muted" />
  </bs:bsui-stack>
  <bs:bsui-field>
    <bs:bsui-field-label text="Workspace name" />
    <bs:bsui-input name="onboarding_workspace" defaultValue="Acme Inc" />
  </bs:bsui-field>
  <bs:bsui-field>
    <bs:bsui-field-label text="Company size" />
    <bs:bsui-select name="company_size" defaultValue="small" placeholder="Pick a size">
      <bs:bsui-select-trigger />
      <bs:bsui-select-popup>
        <bs:bsui-select-option value="solo" label="Just me" />
        <bs:bsui-select-option value="small" label="2 to 10" />
        <bs:bsui-select-option value="mid" label="11 to 50" />
        <bs:bsui-select-option value="large" label="More than 50" />
      </bs:bsui-select-popup>
    </bs:bsui-select>
  </bs:bsui-field>
  <bs:bsui-field>
    <bs:bsui-field-label text="Theme" />
    <bs:bsui-toggle-group defaultValue="system">
      <bs:bsui-toggle-group-item value="light" label="Light" />
      <bs:bsui-toggle-group-item value="dark" label="Dark" />
      <bs:bsui-toggle-group-item value="system" label="System" />
    </bs:bsui-toggle-group>
  </bs:bsui-field>
  <bs:bsui-switch label="Send a weekly usage digest" defaultChecked="true" />
  <bs:bsui-stack direction="row" gap="2" align="center" justify="space-between">
    <bs:bsui-button label="Back" variant="outline" />
    <bs:bsui-button label="Continue" variant="default" />
  </bs:bsui-stack>
</bs:bsui-stack>

How it works

The step index lives in the store, driving both the progress value and which footer actions render, while every control commits into an onboarding draft in context. The theme toggle applies its choice immediately so the screen restyles before Continue is pressed.

Every behaviour on this page is the WordPress Interactivity API: each component registers its own store, seeds its state in a server rendered context, and wires events with directives in the markup above. There is no page specific JavaScript.