Split 404 With Image

Error3: Split 404 With Image

A two-column 404 page: status code, heading, explanation, buttons, and a small follow-up note on one side, a full-bleed image that scales on hover on the other. The image side is controlled by a prop, so the same block covers both mirror layouts.

Installation

Swap YOUR_EMAIL and YOUR_KEY for the email and license key on your account. Find your license key on your account page.

Radix flavor

npx shadcn add "https://ui.beste.co/r/error3?email=YOUR_EMAIL&license_key=YOUR_KEY"

Base UI flavor

npx shadcn add "https://ui.beste.co/r-base/error3?email=YOUR_EMAIL&license_key=YOUR_KEY"

This installs the block to components/beste/block/error3.tsx, plus the button shadcn/ui primitive it uses for the action row.

Quick start

The installed file exports error3Demo alongside the block: the exact props behind the preview above. Spread it to get a working 404 screen in one line.

import { Error3, error3Demo } from "@/components/beste/block/error3";

export default function NotFound() {
  return <Error3 {...error3Demo} />;
}

Then replace the demo with your own props. Written out, a trimmed setup looks like this:

import { ArrowLeft, House } from "lucide-react";
import { Error3 } from "@/components/beste/block/error3";

export default function NotFound() {
  return (
    <Error3
      code="404"
      heading="Nothing lives at this address"
      description="The link you followed is broken or the page has been retired."
      buttons={[
        { label: "Back to home", href: "/", icon: House },
        { label: "Previous page", href: "/docs", variant: "outline", icon: ArrowLeft },
      ]}
      note="If you got here from a link on our site, let us know so we can fix it."
      image={{
        src: "https://images.unsplash.com/photo-1627196038963-7aa32a9121fb?w=1200&h=900&fit=crop",
        alt: "Abstract shapes on a plain background",
      }}
      imagePosition="left"
    />
  );
}

Props

type ActionButton = {
  label: string;
  href: string;
  variant?: "default" | "outline" | "secondary" | "ghost";
  icon?: LucideIcon;
};

Behavior notes

• imagePosition only takes effect at the lg breakpoint, where it flips the order of the two columns. Below that the grid is a single column and the text always comes first, so mobile visitors read the message before the image.
• The image is absolutely positioned inside a 4:3 aspect box with object-cover, so any source ratio crops cleanly instead of stretching the layout.
• Hovering the image column scales the image to 105% over 500ms through the named group/error3 group; the crop container keeps the overflow hidden so the border stays crisp.
• The block is fully static with no client state, so it renders on the server and works with JavaScript disabled.
• Every region is optional: with no image the text column simply occupies the left half of the grid and the right half stays empty.