Onboarding flow
Onboarding flow composed from cards, forms, steppers and navigation buttons.
Use an onboarding flow when setup is easier to complete as a sequence of focused tasks. This example keeps progress beside the current form and groups backward and forward actions so users can understand their place and next step.
Set up your profile
Pair a vertical stepper with one focused form per step. Mark the current step programmatically and keep backward and forward actions together.
Welcome to your workspace
Step 2 of 3 · Profile
Account
DoneSign-in details saved
Profile
CurrentTell your team about you
Preferences
Upcoming · Optional: choose your defaults
<section class="card shadow-sm" aria-labelledby="onboarding-title">
<header class="card-header">
<h3 class="card-title" id="onboarding-title">Welcome to your workspace</h3>
<p class="card-subtitle">Step 2 of 3 · Profile</p>
</header>
<div class="card-body grid gap-4">
<ol class="stepper bg-primary bg-opacity-10 rounded col-12 col-md-4 p-3" role="list" aria-label="Onboarding progress">
<li class="stepper-item is-completed">
<span class="stepper-marker" aria-hidden="true">1</span>
<div class="stepper-content"><strong class="stepper-label">Account</strong> <span class="badge bg-success">Done</span></div>
</li>
<li class="stepper-item" aria-current="step">
<span class="stepper-marker" aria-hidden="true">2</span>
<div class="stepper-content"><strong class="stepper-label">Profile</strong> <span class="badge bg-primary">Current</span></div>
</li>
<li class="stepper-item">
<span class="stepper-marker" aria-hidden="true">3</span>
<div class="stepper-content"><strong class="stepper-label">Preferences</strong><p class="stepper-status">Upcoming · Optional</p></div>
</li>
</ol>
<form class="col-12 col-md-8 d-flex flex-column gap-3" action="/onboarding/preferences" method="post">
<div>
<label class="form-label is-required" for="displayName">Display name</label>
<input class="form-control" id="displayName" name="displayName" type="text" required />
</div>
<div>
<label class="form-label is-required" for="role">Role</label>
<select class="form-select" id="role" name="role" required>
<option value="">Select a role</option>
<option value="developer">Developer</option>
</select>
</div>
<footer class="d-flex flex-column flex-sm-row gap-2">
<button class="btn btn-outline btn-secondary" type="button">Back</button>
<button class="btn btn-solid btn-primary flex-sm-fill" type="submit">
Continue to preferences
</button>
</footer>
</form>
</div>
</section>