Skip to content
caliper ui docs
DemoSign inGet Pro

Pro

Dot matrix 404

A 404 drawn as a dot-matrix sign. The lit dots gather from a scatter on arrival, part around the pointer like iron filings and spring back when it leaves. Under it: a heading, the reason, the way home and suggested pages.

Pro
pnpm dlx shadcn@latest add @caliper/not-found-matrix

This page is off the grid

Error 404. The address may be mistyped, or the page has moved. Try one of these instead.

Installs components/ui/not-found-matrix.tsxDepends on none beyond ReactMotion shared motion tokens

When to use

Use it for

  • The not-found page of a product or marketing site that wants character without noise.
  • Any error code; the sign draws whatever digits it is given.

Skip it when

  • Errors inside the app shell; use the empty state or an inline error.
  • Pages that must load with no script; the plain not-found page has none.

Decisions

Why it is built this way, so you know what to keep when you change your copy.

Behaviour

Everything is said in text
The sign is a canvas hidden from assistive technology. The heading, the reason and the links are ordinary text and links, so the page works with the art hidden.
Motion only when it is seen
The animation stops offscreen and under reduced motion, and never runs a timer while nothing is moving.

Usage

Point to real pages
Suggestions should be the pages people most often wanted from here, not a sitemap.

Installation

terminal
pnpm dlx shadcn@latest add @caliper/not-found-matrix

Adds its 4 files to components/ui/, each with its own stylesheet, and installs their packages. Pro installs with your access token, set up once per project. See Pro access. The first part also adds Caliper UI’s tokens; import them once as in Installation.

Usage

Import it from your copy of the source. The example behind the preview comes with the source.

example.tsx
import { NotFoundMatrix } from "@/components/ui/not-found-matrix"

The worked example comes with Pro

The 32-line example behind the preview opens here, ready to copy.

  • 576 Pro parts, blocks and page templates, all with source
  • $199 once, with a year of updates. What you have stays yours
  • A full refund within 14 days if it is not for you
Checking your licence…

API reference

NotFoundMatrix

component
PropTypeDefault
codestring"404"
titlestring"This page is off the grid"
descriptionstring"The address may be mistyped, or the page has moved. Try one of these instead."
actionsReactNode—
suggestionsreadonly { label: string; href: string; description?: string | undefined; }[]—
classNamestring—

Accessibility

It is built on native elements and keeps aria-hidden and aria-label in step with state.

No custom key handling; Tab and the native activation keys do the work.

Motion

Transitions use the shared duration and easing tokens. Under prefers-reduced-motion those tokens collapse to instant and travel distances go to zero, so state changes still happen without movement.

All Pages examples