String Art

Installation

pnpm dlx shadcn@latest add @cleverui/text-string-art

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

Usage

tsx

import { TextStringArt } from '@/components/ui/text-string-art'

Exampletsx

import { TextStringArt } from '@/components/ui/text-string-art'

export default function TextStringArtDemo() {
  return (
    <div className="relative mx-auto flex min-h-[380px] max-w-4xl flex-col items-center justify-center gap-6 overflow-hidden px-4 py-16 sm:px-6">
      <p className="font-mono text-[11px] uppercase tracking-[0.2em] text-muted-foreground sm:text-xs">
        Spectacle · pins &amp; one thread
      </p>
      <TextStringArt as="h1" text="FORM" className="w-full text-center" />
      <p className="max-w-md text-center text-sm leading-relaxed text-muted-foreground">
        Pins survey the glyph outline. One continuous thread laces chords clipped
        inside the letterforms until the word densifies into type.
      </p>
    </div>
  )
}

API reference

TextStringArt accepts the following props.

Prop	Type	Default	Description
`text`*	`string`	–	budget ≤ 16 chars, pins sample the glyph outlines at display size
`pinPitch`	`number`	`14`	px between pins along the glyph outline
`speed`	`number`	`1`	–
`as`	`'h1' \| 'h2' \| 'h3' \| 'p'`	`'h2'`	heading level of the sr-only text

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

Related components

Dot Matrix Print

The headline prints as a dot-matrix raster, a carriage sweeps once and canvas dots sized by ink density pop in column by column. React and Tailwind tokens via probes; one accent word in primary.

Frottage Rubbing

A graphite rubbing over hidden relief, crayon passes sweep the sheet and the React headline surfaces where pigment catches. Canvas text effect themed by Tailwind token probes.

Compositor's Case

Type set from a visible case, sorts fly from their compartments, land mirrored in the composing stick, and one proof pull flips the React headline readable. Tailwind-token letterpress craft.

Ink Bleed

Letters develop like ink on wet paper, each glyph starts as a soft bleed and contracts to crisp edges, neighbouring bleeds wicking together mid-pass. One development, then stillness.

Kinetic Type Wall

Editorial kinetic type wall for React, outline echoes of the headline drift in alternating directions while one inked row carries the accent word. Tailwind-token themed; hover eases it to a halt.

Neon Bend

The tube bends first, unlit glass traces the headline stroke by stroke, gas ignites in a slow warm-up, and the React neon sign settles steady in Tailwind-token primary glow with an ink core.

Frequently asked questions

How do I install the String Art component?

Register the @cleverui registry in your components.json ("@cleverui": "https://cleverops.com.au/r/{name}.json"), then run `npx shadcn@latest add @cleverui/text-string-art`. 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 String Art require?

String Art has no npm dependencies beyond React and Tailwind CSS itself, so there is nothing extra to install or keep updated.

Can I theme String Art 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