Skip to content
← Blocks

Shape Hero

Bold geometric objects balance a playful studio introduction.

Open ↗

Make it yours.

Install the editable source and its dependencies into your React + Tailwind project.

Scroll horizontally for long lines
pnpm dlx shadcn@4.0.8 add http://localhost:3000/r/shape-hero.json

Use it

Scroll horizontally for long lines
"use client";
import { ShapeHero } from "@/components/jez-ui/blocks/shape-hero";

export default function Example() {
  return (
    <>
      <ShapeHero />
    </>
  );
}

Compose your own

These styled parts are included in the same install. Use children to build your layout; add className only when you want an override.

Scroll horizontally for long lines
"use client";
import {
  ShapeHero,
  ShapeHeroContent,
  ShapeHeroCopyContent,
  ShapeHeroArtwork,
} from "@/components/jez-ui/blocks/shape-hero";
export default function Example() {
  return (
    <ShapeHero>
      <ShapeHeroContent>
        <ShapeHeroCopyContent />
        <ShapeHeroArtwork />
      </ShapeHeroContent>
    </ShapeHero>
  );
}
Scroll horizontally for long lines
import { ShapeHero, ShapeHeroContent, ShapeHeroTitle, ShapeHeroLayout, ShapeHeroAction, ShapeHeroBrand, ShapeHeroDescription, ShapeHeroCopyContent, ShapeHeroArtwork } from "@/components/jez-ui/blocks/shape-hero";
Read the composition guide →

Props & types

Scroll horizontally for long lines
export type ShapeHeroOptions = Pick<
  HeroProps,
  "copy" | "title" | "actionLabel" | "description" | "className" | "href"
>;

export type ShapeHeroProps = Omit<
  React.ComponentProps<"section">,
  keyof ShapeHeroOptions
> &
  ShapeHeroOptions;

ShapeHeroProps

Source

View 3 source files

registry/blocks/shape-hero.tsx

Scroll horizontally for long lines
"use client";
import * as React from "react";
import { cn } from "../ui/utils";
import { HeroLink, type HeroProps } from "./hero-parts";
export const ShapeHeroCopy = {
  brand: "Playroom.",
};
export type ShapeHeroOptions = Pick<
  HeroProps,
  "copy" | "title" | "actionLabel" | "description" | "className" | "href"
>;
export type ShapeHeroProps = Omit<
  React.ComponentProps<"section">,
  keyof ShapeHeroOptions
> &
  ShapeHeroOptions;
function useShapeHeroModel({
  copy = {},
  title,
  actionLabel,
  description,
  className,
  href = "/blocks",
  children,
  ...rootProps
}: ShapeHeroProps) {
  return {
    copy,
    title,
    actionLabel,
    description,
    className,
    href,
    children,
    rootProps,
  };
}
const ShapeHeroCompositionContext = React.createContext<ReturnType<
  typeof useShapeHeroModel
> | null>(null);
function useShapeHeroComposition() {
  const context = React.useContext(ShapeHeroCompositionContext);
  if (!context) throw new Error("ShapeHero parts must be inside ShapeHero.");
  return context;
}
export function ShapeHero(props: ShapeHeroProps) {
  const model = useShapeHeroModel(props);
  const { className, rootProps, children } = model;
  return (
    <ShapeHeroCompositionContext.Provider value={model}>
      <section
        {...rootProps}
        className={cn(
          "relative isolate overflow-hidden rounded-xl bg-[#f1eddc] text-[#27392c]",
          className,
        )}
      >
        {children !== undefined ? children : <ShapeHeroLayout />}
      </section>
    </ShapeHeroCompositionContext.Provider>
  );
}

export function ShapeHeroContent({
  className,
  ...props
}: React.ComponentProps<"div">) {
  return (
    <div
      data-slot="shape-hero-content"
      className={cn("grid md:grid-cols-2", className)}
      {...props}
    />
  );
}
export function ShapeHeroTitle({
  className,
  ...props
}: React.ComponentProps<"h1">) {
  return (
    <h1
      data-slot="shape-hero-title"
      className={cn(
        "mt-16 font-display text-5xl leading-none tracking-tight md:text-6xl",
        className,
      )}
      {...props}
    />
  );
}

export function ShapeHeroLayout({
  children,
  ...props
}: Partial<React.ComponentProps<typeof ShapeHeroContent>> & {
  children?: React.ReactNode;
}) {
  return (
    <ShapeHeroContent {...props}>
      {children === undefined ? (
        <>
          <ShapeHeroCopyContent />
          <ShapeHeroArtwork />
        </>
      ) : (
        children
      )}
    </ShapeHeroContent>
  );
}

export function ShapeHeroAction({
  children,
  ...props
}: Partial<React.ComponentProps<typeof HeroLink>> & {
  children?: React.ReactNode;
}) {
  const { actionLabel, href } = useShapeHeroComposition();
  return (
    <HeroLink href={href} {...props}>
      {children === undefined ? (actionLabel ?? "Make something") : children}
    </HeroLink>
  );
}
export function ShapeHeroBrand({
  children,
  ...props
}: Partial<React.ComponentProps<"span">> & { children?: React.ReactNode }) {
  const { copy } = useShapeHeroComposition();
  return (
    <span
      {...props}
      className={cn("font-display text-xl font-semibold", props.className)}
    >
      {children === undefined ? (copy.brand ?? "Playroom.") : children}
    </span>
  );
}
export function ShapeHeroDescription({
  children,
  ...props
}: Partial<React.ComponentProps<"p">> & { children?: React.ReactNode }) {
  const { description } = useShapeHeroComposition();
  return (
    <p
      {...props}
      className={cn("my-7 max-w-xs text-sm leading-relaxed", props.className)}
    >
      {children === undefined
        ? (description ??
          "The best ideas start with a little curiosity. Tools and objects for your next happy accident.")
        : children}
    </p>
  );
}
export function ShapeHeroCopyContent({
  children,
  ...props
}: Partial<React.ComponentProps<"div">> & { children?: React.ReactNode }) {
  const { title } = useShapeHeroComposition();
  return (
    <div {...props} className={cn("p-8 md:p-12", props.className)}>
      {children === undefined ? (
        <>
          <ShapeHeroBrand />
          <ShapeHeroTitle>
            {title ?? (
              <>
                Serious about
                <br />
                <span className="font-serif italic font-normal">playing.</span>
              </>
            )}
          </ShapeHeroTitle>
          <ShapeHeroDescription />
          <ShapeHeroAction />
        </>
      ) : (
        children
      )}
    </div>
  );
}

export function ShapeHeroArtwork({
  children,
  className,
  ...props
}: React.ComponentProps<"div">) {
  return (
    <div
      aria-hidden="true"
      {...props}
      className={cn("grid min-h-80 grid-cols-2 gap-3 p-8 md:py-16", className)}
    >
      {children === undefined ? (
        <>
          <div className="aspect-square rounded-full bg-[#d76740]" />
          <div className="aspect-square rounded-t-full bg-[#bec99c]" />
          <div className="aspect-square rounded-br-full bg-[#e0b740]" />
          <div className="grid aspect-square place-items-center rounded-full border-[28px] border-[#344b3b]">
            <span className="size-8 rounded-full bg-[#d76740]" />
          </div>
        </>
      ) : (
        children
      )}
    </div>
  );
}

registry/ui/utils.ts

Scroll horizontally for long lines
import { clsx, type ClassValue } from "clsx";
import { twMerge } from "tailwind-merge";
export function cn(...values: ClassValue[]) {
  return twMerge(clsx(values));
}

registry/blocks/hero-parts.tsx

Scroll horizontally for long lines
"use client";
import * as React from "react";
import { Slot } from "radix-ui";
import { ArrowUpRight } from "lucide-react";
import { cn } from "../ui/utils";
export type HeroCopy = Partial<
  Record<
    | "brand"
    | "meta"
    | "eyebrow"
    | "tagline"
    | "taglineEnd"
    | "caption"
    | "footerNote"
    | "animationName"
    | "playLabel"
    | "pauseLabel"
    | "artworkLabel",
    string
  >
>;
export type HeroProps = {
  copy?: HeroCopy;
  preview?: React.ReactNode;
  artworkText?: string;
  className?: string;
  href?: string;
  title?: React.ReactNode;
  description?: React.ReactNode;
  actionLabel?: React.ReactNode;
  secondaryImageSrc?: string;
  secondaryImageAlt?: string;
  imageSrc?: string;
  imageAlt?: string;
  artwork?: {
    color?: string;
    speed?: number;
    label?: string;
    playLabel?: string;
    pauseLabel?: string;
  };
};
export function HeroLink({
  href = "/blocks",
  asChild,
  children = "Explore the collection",
  className,
  ...props
}: React.ComponentProps<"a"> & {
  asChild?: boolean;
  href?: string;
  children?: React.ReactNode;
  className?: string;
}) {
  const Comp = asChild ? Slot.Root : "a";
  return (
    <Comp
      {...props}
      href={href}
      className={cn(
        "inline-flex items-center gap-3 rounded-full border border-current/30 px-5 py-3 text-sm transition-colors hover:bg-current/10",
        className,
      )}
    >
      {asChild ? (
        children
      ) : (
        <>
          {children}
          <ArrowUpRight size={16} />
        </>
      )}
    </Comp>
  );
}

Dependencies

clsx@2.1.1 · tailwind-merge@3.5.0 · radix-ui@1.6.7 · lucide-react@0.577.0

Accessibility & behaviour

Provide meaningful labels and preserve keyboard focus styles. Check contrast when customising theme colours.

Read the accessibility and performance guide →