Skip to content
Product block

Data Migration Split

What a migration actually moves and what it cannot, stated before the switch rather than discovered after it.

158 linesNo dependenciesAdded 9 Sept 2026Updated 13 Sept 2026
  • migration
  • onboarding
  • import
  • switching
  • data

What's included

  • components/data-migration-split.tsx
  • No runtime dependencies

Works with

  • React
  • Next.js
  • Tailwind CSS
  • TypeScript

npx hoverlab add data-migration-split

Or over MCP, from your editor's agent — no account needed.

License

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.

Was this useful?

Start a page with this section — add more, order them, and leave with the page source.

Preview

Switching

We move it, and we say what we cannot

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.

  • Records, history and attachmentsEverything with a stable id, including the timestamps, so reports still line up.
  • Users and their permissionsRoles are mapped, and the mapping is shown for approval before anything is written.
  • What does not come acrossCustom automations. The triggers have no equivalent here and a silent half-migration is worse.
  • Run it twiceA trial into a sandbox first, then the real one. The trial is free and does not count against anything.

Rendered live in your current theme — this is the same component whose source is below, not a screenshot of it.

Source

components/data-migration-split.tsx
/**
 * <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>
  )
}

Before you paste

  • Styling is Tailwind utility classes on semantic tokens (bg-card, text-muted-foreground) — it inherits your theme instead of overriding it.
  • Nothing to install. No component library, no icon package.
  • Every prop has a default, so it renders standalone before you wire it up.

Where it goes

Drop it at components/data-migration-split.tsx and import it where you need the section:

import { DataMigrationSplit } from '@/components/data-migration-split'

Customize

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.

Props

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.

PropTypeDefault
eyebrowstring"Switching"
headingstring"We move it, and we say what we cannot"
introstring—
pointsDataMigrationSplitPoint[]POINTS
mediaYour own visual. Omit for the drawn panel, which needs no asset.React.ReactNode—
classNamestring—

Not using React?

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.html
<!--
  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>
  • This is rendered HTML, not a translation of the React source. The Tailwind classes carry the design and work in any framework.
  • It is one frame: the component in its initial state, with no props applied beyond the defaults.
  • This block is interactive in React — toggles, menus or form state. None of that survives here; the markup is the closed/default state and the handlers are gone. Re-wire them in your own framework.
  • Requires Tailwind, and the design tokens the classes reference (bg-card, text-muted-foreground, and so on). The template ZIPs ship a globals.css that defines them.

What each framework gets across the whole catalog — effects convert properly; this rung is markup.

For AI

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.

See the prompt

Used in these pages

Want the whole screen instead of this one section? Open a page and copy it entire.

7 more blocks in Onboarding

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 Onboarding

Shipping one commercially

Copying the code is free. Putting it in client work or a paid product is what Pro is for — the licence, not the access.

  • A commercial licence for everything in the catalog
  • Unlimited bundle exports, in Vue, Svelte and Tailwind
  • One payment — no subscription, nothing to renew
Pro — $79 once

More Onboarding blocks

View category
Open the full page for this block

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.

Onboarding230 lines1 dep
Open the full page for this block

Guided Setup Wizard

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.

Onboarding265 lines1 dep
Open the full page for this block

Team Invite Step

The onboarding step where a product becomes multiplayer: pasted addresses split into chips, typos marked rather than dropped, and an honest way to skip.

Onboarding279 lines1 dep
Open the full page for this block

Product Tour Coach Mark

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.

Onboarding262 lines1 dep
Open the full page for this block

Role Picker

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.

Onboarding191 lines1 dep
Open the full page for this block

Import or Start Empty

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.

Onboarding216 lines1 dep
Open the full page for this block

Workspace Setup Form

The first screen after signup, asking only the two things that cannot be changed silently later.

Onboarding176 linesNo deps