Setup Checklist with Progress
The get-started card that ships with its first item already ticked, a native <progress> element rather than a div bar, and a dismiss control that appears only once there is nothing left to abandon.
What a migration actually moves and what it cannot, stated before the switch rather than discovered after it.
components/data-migration-split.tsxnpx hoverlab add data-migration-split
Or over MCP, from your editor's agent — no account needed.
Free to read, copy and install, for personal and non-commercial projects. Shipping it in client work or a paid product needs Pro ($79 once). The source lands in your repo and stops being ours — no attribution, nothing to upgrade.
Start a page with this section — add more, order them, and leave with the page source.
Switching
Every migration page promises everything comes across. Something never does, and finding out which thing after the cutover is how a switch becomes a rollback.
Rendered live in your current theme — this is the same component whose source is below, not a screenshot of it.
/**
* <DataMigrationSplit> — What a migration actually moves and what it cannot, stated before the switch rather than discovered after it.
*
* Every migration page promises that everything comes across. Something
* never does, and finding out which thing after the cutover is how a switch
* becomes a rollback. The layout problem is that the honest version of this
* section has a negative in it, and negatives are what marketing pages
* remove.
*
* So the third point is what does not come across, and it is specific:
* custom automations, because the triggers have no equivalent. The obvious
* wrong answer is to omit it and handle the objection in the sales call,
* which works right up until the customer has already switched.
*
* The fourth point is the one that makes the third survivable. A trial
* migration into a sandbox lets the gap be discovered before the cutover
* rather than after, and it is free — a paid trial migration would defeat
* the purpose of offering one.
*
* The permissions point says the role mapping is shown for approval before
* anything is written. That is the step most migrations skip, and it is
* where a "successful" migration quietly gives twelve people admin.
*
* Accessibility: the tick `<svg>` is `aria-hidden` with `currentColor`, so
* it is decoration that inherits the text colour rather than four
* announcements of nothing; the heading provides the section's accessible
* name through `aria-labelledby`; the points are a genuine `<ul>`.
*
* The panel is drawn rather than an `<img>` — no asset, no layout shift, and
* it themes with the page instead of being somebody's light-mode
* screenshot sitting in a dark one.
*/
import * as React from 'react'
export interface DataMigrationSplitPoint {
label: string
detail?: string
}
export interface DataMigrationSplitProps {
eyebrow?: string
heading?: string
intro?: string
points?: DataMigrationSplitPoint[]
/** Your own visual. Omit for the drawn panel, which needs no asset. */
media?: React.ReactNode
className?: string
}
const POINTS: DataMigrationSplitPoint[] = [
{ label: "Records, history and attachments", detail: "Everything with a stable id, including the timestamps, so reports still line up." },
{ label: "Users and their permissions", detail: "Roles are mapped, and the mapping is shown for approval before anything is written." },
{ label: "What does not come across", detail: "Custom automations. The triggers have no equivalent here and a silent half-migration is worse." },
{ label: "Run it twice", detail: "A trial into a sandbox first, then the real one. The trial is free and does not count against anything." },
]
/**
* A per-instance heading id, derived rather than generated.
*
* `React.useId()` is the textbook fix for a literal id in a reusable
* component and is not available here: this block has no `'use client'`
* and does not warrant one. It renders text, and a band that hydrates on
* every page to render text is a cost with nothing on the other side of
* it. Same call, and the same reasoning, as `footer-mega`.
*
* Hashing the heading *and* the intro is deliberate. Either alone works
* until two callers happen to agree, which is exactly what a catalog hub
* rendering every page into one document arranges for; between them they
* are the two props nobody leaves at the default.
*/
function headingId(heading: string, intro: string): string {
let hash = 0
const source = `${heading}|${intro}`
for (let i = 0; i < source.length; i++) {
hash = (Math.imul(hash, 31) + source.charCodeAt(i)) | 0
}
return `data-migration-split-heading-${(hash >>> 0).toString(36).slice(0, 4)}`
}
export function DataMigrationSplit({
eyebrow = "Switching",
heading = "We move it, and we say what we cannot",
intro = "Every migration page promises everything comes across. Something never does, and finding out which thing after the cutover is how a switch becomes a rollback.",
points = POINTS,
media,
className,
}: DataMigrationSplitProps) {
return (
<section
aria-labelledby={headingId(heading, intro)}
className={`w-full bg-background px-6 py-16 sm:py-24 ${className ?? ''}`}
>
<div className="mx-auto grid max-w-6xl items-center gap-12 lg:grid-cols-2">
<div>
<p className="text-sm font-medium text-primary">{eyebrow}</p>
<h2
id={headingId(heading, intro)}
className="mt-2 text-3xl font-semibold tracking-tight text-foreground sm:text-4xl"
>
{heading}
</h2>
<p className="mt-4 text-base text-muted-foreground">{intro}</p>
<ul className="mt-8 space-y-4">
{points.map((point) => (
<li key={point.label} className="flex gap-3">
{/*
currentColor, not a token in a raw colour function. These
are complete oklch() values, so hsl(var(--primary)) is not
a colour and the declaration is dropped silently.
*/}
<svg
aria-hidden="true"
viewBox="0 0 20 20"
className="mt-0.5 size-5 shrink-0 text-primary"
fill="currentColor"
>
<path d="M16.7 5.3a1 1 0 0 1 0 1.4l-7.5 7.5a1 1 0 0 1-1.4 0L3.3 9.7a1 1 0 1 1 1.4-1.4l3.8 3.8 6.8-6.8a1 1 0 0 1 1.4 0Z" />
</svg>
<span>
<span className="block text-sm font-medium text-foreground">{point.label}</span>
{point.detail ? (
<span className="mt-0.5 block text-sm text-muted-foreground">
{point.detail}
</span>
) : null}
</span>
</li>
))}
</ul>
</div>
{/*
The drawn panel rather than an <img>. No asset to host, no layout
shift while it loads, and it themes with the rest of the page —
which a screenshot of somebody's light-mode dashboard does not.
*/}
<div className="rounded-xl border border-border bg-card p-6 shadow-sm">
{media ?? (
<div aria-hidden="true" className="space-y-3">
<div className="h-3 w-1/3 rounded bg-primary/30 border border-transparent" />
<div className="h-24 rounded-lg bg-muted border border-transparent" />
<div className="grid grid-cols-3 gap-3">
<div className="h-14 rounded-lg bg-muted border border-transparent" />
<div className="h-14 rounded-lg bg-muted border border-transparent" />
<div className="h-14 rounded-lg bg-muted border border-transparent" />
</div>
<div className="h-3 w-2/3 rounded bg-muted border border-transparent" />
<div className="h-3 w-1/2 rounded bg-muted border border-transparent" />
</div>
)}
</div>
</div>
</section>
)
}
bg-card, text-muted-foreground) — it inherits your theme instead of overriding it.Drop it at components/data-migration-split.tsx and import it where you need the section:
import { DataMigrationSplit } from '@/components/data-migration-split'2 of this block’s props are simple enough to drive from here. Change them and the block below re-renders — it is the same component whose source is above, not a mock of it. Everything else it accepts is in the table underneath.
Read out of the component’s own type and signature, so this cannot drift from the source below. Every prop has a default — the component renders standalone before you pass it anything.
| Prop | Type | Default |
|---|---|---|
eyebrow | string | "Switching" |
heading | string | "We move it, and we say what we cannot" |
intro | string | — |
points | DataMigrationSplitPoint[] | POINTS |
mediaYour own visual. Omit for the drawn panel, which needs no asset. | React.ReactNode | — |
className | string | — |
The same block rendered once to markup, wrapped as a file your framework compiles. Tailwind classes are framework-agnostic, so the design transfers intact — the behaviour does not.
This block is interactive. The markup below is its initial state with the event handlers stripped — you will need to re-wire the behaviour in your framework.
<!--
Data Migration Split — markup from the Hoverlab catalog.
This is the block rendered once to HTML and wrapped as a component
file. It is not a port of the React source: the Tailwind classes carry
the design, which is the part that took the work, and they are the same
in every framework.
This block is interactive in React and the handlers are NOT here.
Buttons, toggles and menus render in their initial state and do
nothing until you wire them up.
-->
<section aria-labelledby="data-migration-split-heading-19a8" class="w-full bg-background px-6 py-16 sm:py-24 ">
<div class="mx-auto grid max-w-6xl items-center gap-12 lg:grid-cols-2">
<div>
<p class="text-sm font-medium text-primary">Switching</p>
<h2 id="data-migration-split-heading-19a8" class="mt-2 text-3xl font-semibold tracking-tight text-foreground sm:text-4xl">We move it, and we say what we cannot</h2>
<p class="mt-4 text-base text-muted-foreground">Every migration page promises everything comes across. Something never does, and finding out which thing after the cutover is how a switch becomes a rollback.</p>
<ul class="mt-8 space-y-4">
<li class="flex gap-3">
<svg aria-hidden="true" viewBox="0 0 20 20" class="mt-0.5 size-5 shrink-0 text-primary" fill="currentColor">
<path d="M16.7 5.3a1 1 0 0 1 0 1.4l-7.5 7.5a1 1 0 0 1-1.4 0L3.3 9.7a1 1 0 1 1 1.4-1.4l3.8 3.8 6.8-6.8a1 1 0 0 1 1.4 0Z"></path>
</svg>
<span>
<span class="block text-sm font-medium text-foreground">Records, history and attachments</span>
<span class="mt-0.5 block text-sm text-muted-foreground">Everything with a stable id, including the timestamps, so reports still line up.</span>
</span>
</li>
<li class="flex gap-3">
<svg aria-hidden="true" viewBox="0 0 20 20" class="mt-0.5 size-5 shrink-0 text-primary" fill="currentColor">
<path d="M16.7 5.3a1 1 0 0 1 0 1.4l-7.5 7.5a1 1 0 0 1-1.4 0L3.3 9.7a1 1 0 1 1 1.4-1.4l3.8 3.8 6.8-6.8a1 1 0 0 1 1.4 0Z"></path>
</svg>
<span>
<span class="block text-sm font-medium text-foreground">Users and their permissions</span>
<span class="mt-0.5 block text-sm text-muted-foreground">Roles are mapped, and the mapping is shown for approval before anything is written.</span>
</span>
</li>
<li class="flex gap-3">
<svg aria-hidden="true" viewBox="0 0 20 20" class="mt-0.5 size-5 shrink-0 text-primary" fill="currentColor">
<path d="M16.7 5.3a1 1 0 0 1 0 1.4l-7.5 7.5a1 1 0 0 1-1.4 0L3.3 9.7a1 1 0 1 1 1.4-1.4l3.8 3.8 6.8-6.8a1 1 0 0 1 1.4 0Z"></path>
</svg>
<span>
<span class="block text-sm font-medium text-foreground">What does not come across</span>
<span class="mt-0.5 block text-sm text-muted-foreground">Custom automations. The triggers have no equivalent here and a silent half-migration is worse.</span>
</span>
</li>
<li class="flex gap-3">
<svg aria-hidden="true" viewBox="0 0 20 20" class="mt-0.5 size-5 shrink-0 text-primary" fill="currentColor">
<path d="M16.7 5.3a1 1 0 0 1 0 1.4l-7.5 7.5a1 1 0 0 1-1.4 0L3.3 9.7a1 1 0 1 1 1.4-1.4l3.8 3.8 6.8-6.8a1 1 0 0 1 1.4 0Z"></path>
</svg>
<span>
<span class="block text-sm font-medium text-foreground">Run it twice</span>
<span class="mt-0.5 block text-sm text-muted-foreground">A trial into a sandbox first, then the real one. The trial is free and does not count against anything.</span>
</span>
</li>
</ul>
</div>
<div class="rounded-xl border border-border bg-card p-6 shadow-sm">
<div aria-hidden="true" class="space-y-3">
<div class="h-3 w-1/3 rounded bg-primary/30 border border-transparent"></div>
<div class="h-24 rounded-lg bg-muted border border-transparent"></div>
<div class="grid grid-cols-3 gap-3">
<div class="h-14 rounded-lg bg-muted border border-transparent"></div>
<div class="h-14 rounded-lg bg-muted border border-transparent"></div>
<div class="h-14 rounded-lg bg-muted border border-transparent"></div>
</div>
<div class="h-3 w-2/3 rounded bg-muted border border-transparent"></div>
<div class="h-3 w-1/2 rounded bg-muted border border-transparent"></div>
</div>
</div>
</div>
</section>
What each framework gets across the whole catalog — effects convert properly; this rung is markup.
The component, its props, the design tokens it expects and the command that installs it — as one prompt. Paste it into Claude, Cursor, v0 or ChatGPT and what they build around it will match the rest of the catalog instead of inventing its own system.
Want the whole screen instead of this one section? Open a page and copy it entire.
All of them free to read, copy and install — no account, no locked tiles, no watermarked preview. The whole catalog is open, and so are the API and the CLI.
Browse OnboardingCopying the code is free. Putting it in client work or a paid product is what Pro is for — the licence, not the access.
The get-started card that ships with its first item already ticked, a native <progress> element rather than a div bar, and a dismiss control that appears only once there is nothing left to abandon.
A choice-driven wizard with a persistent side rail, real radio groups in a fieldset so arrow keys work, and visited steps navigable while steps ahead stay out of the tab order.
The onboarding step where a product becomes multiplayer: pasted addresses split into chips, typos marked rather than dropped, and an honest way to skip.
A tour step anchored to the control it explains, with a spotlight cut by one spread shadow, a visible step count and focus that follows the step.
The "what best describes you" step, asked honestly — every option states what it actually changes, the skip is visible and names what you get instead, and the choice is reversible.
The empty product’s real first question. Sample data is offered with equal weight rather than as grey small print, every connector names its scope before the redirect, and each option carries the honest duration.
The first screen after signup, asking only the two things that cannot be changed silently later.