Ink Roller

Installation

pnpm dlx shadcn@latest add @cleverui/scroll-ink-roller

Requires the @cleverui registry in your components.json, a one-off, two-line setup.

Usage

tsx

import { ScrollInkRoller } from '@/components/blocks/scroll-ink-roller'

Exampletsx

import { ScrollInkRoller } from '@/components/blocks/scroll-ink-roller'

export default function ScrollInkRollerDemo() {
  return (
    <ScrollInkRoller
      eyebrow="Press hall · Folio 12"
      heading="Blueprint below. Ink above."
      lede="A fixed press line develops each block from survey proof into finished ink as you scroll. Reverse the page and the plates return to dashed keylines, the instrument never moves."
      lineOffset={0.66}
      panels={[
        {
          title: 'Survey the form first',
          body: 'Hairline boxes and dashed keylines hold the structure before any ink lands. The press line is the only accent, a mono readout ticks printed percentage as blocks cross.',
        },
        {
          title: 'Develop through the roller',
          body: 'Identical geometry stacks as proof and ink. Clip-path insets trade one for the other at the instrument edge, so every intermediate frame is a composed half-print.',
        },
        {
          title: 'Hold the finished sheet',
          body: 'Once a panel clears the line it stays fully inked, card surface, border, and type weight locked. Scroll back and the blueprint reappears without a one-shot reveal.',
        },
      ]}
    />
  )
}

API reference

ScrollInkRoller accepts the following props.

Prop	Type	Default	Description
`eyebrow`	`string`	–	–
`heading`*	`string`	–	–
`lede`	`string`	–	standfirst under the heading
`panels`*	`InkRollerPanel[]`	–	2–4 feature panels that develop from proof to ink
`lineOffset`	`number`	`0.66`	press line position as a viewport height fraction

…plus everything from React.HTMLAttributes<HTMLElement>: className, event handlers, aria attributes and the rest pass straight through.

Referenced types

Typestsx

export interface InkRollerPanel {
  title: string
  body: string
}

Related components

Core Sample

Scroll drills a core sample through labeled strata, the bit sinks, the extraction tube fills layer by layer, and a depth log counts to the primary seam. React and Tailwind tokens, no assets.

Exploded View

A pinned exploded-view scene for React, scroll separates a token-built 3D assembly into labeled plates with hairline leader lines, zero image assets. Native scroll, Tailwind-themed, poster-safe.

Gearworks

Scroll cranks a meshed SVG gear train, exact tooth ratios counter-rotate hairline gears until the primary dial needle lands on your stat. React and Tailwind tokens, native scroll scrub, no assets.

Reveal Group

A choreography wrapper that gives arbitrary children the library's signature staggered entrance, direction, distance and stagger as props, revealed once and never replayed.

Sundial

Scroll runs the sun across a drafted sundial, the shadow wedge sweeps hour ticks, pinning content to times of day until the marked hour lights. React and Tailwind tokens, native scroll.

Suspension Span

Scroll builds a suspension bridge from dashed survey plan to open span, towers rise, catenary cables draw, hangers drop, the deck crosses. React and Tailwind tokens, fully reversible.

Frequently asked questions

How do I install the Ink Roller component?

Register the @cleverui registry in your components.json ("@cleverui": "https://cleverops.com.au/r/{name}.json"), then run `npx shadcn@latest add @cleverui/scroll-ink-roller`. The shadcn CLI copies the source into your project, you own the code from that point. You can also copy the source directly from this page.

What dependencies does Ink Roller require?

Ink Roller uses motion on top of React and Tailwind CSS. You don't need to install it manually, the shadcn CLI resolves and installs npm dependencies automatically when you add the component.

Can I theme Ink Roller to match my brand?

Yes. The component is styled entirely with Tailwind utilities over standard design tokens (primary, background, muted, border), so it inherits your existing shadcn/ui theme automatically. Change your CSS variables and the component follows, no source edits needed for palette, radius, or fonts.

Preview & code