Skip to content
← Blocks

Feature Comparison

A complete feature comparison section, ready to adapt to your product.

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/feature-comparison.json

Use it

Scroll horizontally for long lines
"use client";
import { FeatureComparison } from "@/components/jez-ui/blocks/feature-comparison";

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

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 {
  FeatureComparison,
  FeatureComparisonHeading,
  FeatureComparisonLead,
  FeatureComparisonMatrix,
  FeatureComparisonStatus,
} from "@/components/jez-ui/blocks/feature-comparison";

export default function Example() {
  return (
    <FeatureComparison>
      <FeatureComparisonHeading />
      <FeatureComparisonLead />
      <FeatureComparisonMatrix />
      <FeatureComparisonStatus />
    </FeatureComparison>
  );
}
Scroll horizontally for long lines
import { FeatureComparison, FeatureComparisonTitle, FeatureComparisonDescription, FeatureComparisonContent, FeatureComparisonHeading, FeatureComparisonLead, FeatureComparisonMatrix, FeatureComparisonStatus, FeatureComparisonTable, FeatureComparisonTableHeader, FeatureComparisonRow, FeatureComparisonHead, FeatureComparisonTableBody, FeatureComparisonCell } from "@/components/jez-ui/blocks/feature-comparison";
Read the composition guide →

Props & types

Scroll horizontally for long lines
export type FeatureComparisonPlan = {
  id: string;
  name: React.ReactNode;
  price: React.ReactNode;
  action?: React.ReactNode;
};

export type FeatureComparisonRow = {
  id: string;
  label: React.ReactNode;
  group?: React.ReactNode;
  values: Record<string, React.ReactNode>;
};

export type FeatureComparisonOptions = {
  title?: React.ReactNode;
  description?: React.ReactNode;
  plans?: FeatureComparisonPlan[];
  rows?: FeatureComparisonRow[];
  caption?: string;
  onSelect?: (plan: string) => void;
  highlightedPlan?: string;
};

export type FeatureComparisonProps = Omit<
  React.ComponentProps<"section">,
  keyof FeatureComparisonOptions
> &
  FeatureComparisonOptions;

FeatureComparisonProps

Source

View 3 source files

registry/blocks/feature-comparison.tsx

Scroll horizontally for long lines
"use client";
import * as React from "react";
import { cn } from "../ui/utils";
import { Button } from "../ui/button";
export type FeatureComparisonPlan = {
  id: string;
  name: React.ReactNode;
  price: React.ReactNode;
  action?: React.ReactNode;
};
export type FeatureComparisonRow = {
  id: string;
  label: React.ReactNode;
  group?: React.ReactNode;
  values: Record<string, React.ReactNode>;
};
const defaultPlans: FeatureComparisonPlan[] = [
  {
    id: "Personal",
    name: "Personal",
    price: (
      <>
        £8<span className="text-xs"> / month</span>
      </>
    ),
  },
  {
    id: "Studio",
    name: "Studio",
    price: (
      <>
        £32<span className="text-xs"> / month</span>
      </>
    ),
  },
];
const defaultRows: FeatureComparisonRow[] = [
  {
    id: "projects",
    group: "Workspace",
    label: "Projects",
    values: { Personal: "3", Studio: "Unlimited" },
  },
  {
    id: "people",
    label: "Collaborators",
    values: { Personal: "1", Studio: "Unlimited" },
  },
  {
    id: "domains",
    group: "Publishing",
    label: "Custom domains",
    values: { Personal: "1", Studio: "Unlimited" },
  },
  {
    id: "branding",
    label: "Remove branding",
    values: { Personal: "No", Studio: "Yes" },
  },
  {
    id: "history",
    group: "Support",
    label: "Version history",
    values: { Personal: "7 days", Studio: "Unlimited" },
  },
  {
    id: "support",
    label: "Support channel",
    values: { Personal: "Community", Studio: "Priority email" },
  },
];
export type FeatureComparisonOptions = {
  title?: React.ReactNode;
  description?: React.ReactNode;
  plans?: FeatureComparisonPlan[];
  rows?: FeatureComparisonRow[];
  caption?: string;
  onSelect?: (plan: string) => void;
  highlightedPlan?: string;
};
export type FeatureComparisonProps = Omit<
  React.ComponentProps<"section">,
  keyof FeatureComparisonOptions
> &
  FeatureComparisonOptions;
function useFeatureComparisonModel({
  className,
  title = "Compare the details.",
  description = "Illustrative plans · GBP per workspace, billed monthly.",
  plans = defaultPlans,
  rows = defaultRows,
  caption = "Plan features",
  highlightedPlan = "Studio",
  onSelect,
  children,
  ...props
}: FeatureComparisonProps) {
  const [message, setMessage] = React.useState("");
  return {
    className,
    title,
    description,
    plans,
    rows,
    caption,
    highlightedPlan,
    onSelect,
    children,
    props,
    message,
    setMessage,
  };
}
const FeatureComparisonCompositionContext = React.createContext<ReturnType<
  typeof useFeatureComparisonModel
> | null>(null);
function useFeatureComparisonComposition() {
  const context = React.useContext(FeatureComparisonCompositionContext);
  if (!context)
    throw new Error(
      "FeatureComparison parts must be inside FeatureComparison.",
    );
  return context;
}
export function FeatureComparison(props: FeatureComparisonProps) {
  const model = useFeatureComparisonModel(props);
  const { className, props: rootProps, children } = model;
  return (
    <FeatureComparisonCompositionContext.Provider value={model}>
      <section {...rootProps} className={cn("min-w-0 py-8", className)}>
        {children !== undefined ? (
          children
        ) : (
          <>
            <FeatureComparisonHeading />
            <FeatureComparisonLead />
            <FeatureComparisonMatrix />
            <FeatureComparisonStatus />
          </>
        )}
      </section>
    </FeatureComparisonCompositionContext.Provider>
  );
}

export function FeatureComparisonTitle({
  className,
  ...props
}: React.ComponentProps<"h2">) {
  return (
    <h2
      data-slot="feature-comparison-title"
      className={cn("text-4xl tracking-tight", className)}
      {...props}
    />
  );
}
export function FeatureComparisonDescription({
  className,
  ...props
}: React.ComponentProps<"p">) {
  return (
    <p
      data-slot="feature-comparison-description"
      className={cn("mt-4 text-sm text-muted-foreground", className)}
      {...props}
    />
  );
}
export function FeatureComparisonContent({
  className,
  ...props
}: React.ComponentProps<"div">) {
  return (
    <div
      data-slot="feature-comparison-content"
      className={cn("mt-8 overflow-x-auto", className)}
      {...props}
    />
  );
}

export function FeatureComparisonHeading({
  children,
  ...props
}: Partial<React.ComponentProps<typeof FeatureComparisonTitle>> & {
  children?: React.ReactNode;
}) {
  const { title } = useFeatureComparisonComposition();
  return (
    <FeatureComparisonTitle {...props}>
      {children === undefined ? title : children}
    </FeatureComparisonTitle>
  );
}
export function FeatureComparisonLead({
  children,
  ...props
}: Partial<React.ComponentProps<typeof FeatureComparisonDescription>> & {
  children?: React.ReactNode;
}) {
  const { description } = useFeatureComparisonComposition();
  return (
    <FeatureComparisonDescription {...props}>
      {children === undefined ? description : children}
    </FeatureComparisonDescription>
  );
}
export function FeatureComparisonMatrix({
  children,
  ...props
}: Partial<React.ComponentProps<typeof FeatureComparisonContent>> & {
  children?: React.ReactNode;
}) {
  const { plans, rows, caption, highlightedPlan, onSelect, setMessage } =
    useFeatureComparisonComposition();
  return (
    <FeatureComparisonContent
      role="region"
      aria-label={caption}
      tabIndex={0}
      {...props}
    >
      {children === undefined ? (
        <FeatureComparisonTable>
          <caption className="sr-only">{caption}</caption>
          <FeatureComparisonTableHeader>
            <FeatureComparisonRow>
              <FeatureComparisonHead scope="col">
                Included
              </FeatureComparisonHead>
              {plans.map((plan) => (
                <th
                  scope="col"
                  key={plan.id}
                  className={cn(
                    "p-4",
                    plan.id === highlightedPlan && "bg-muted",
                  )}
                >
                  <span className="block text-lg">{plan.name}</span>
                  <span className="mt-2 block text-3xl font-normal">
                    {plan.price}
                  </span>
                </th>
              ))}
            </FeatureComparisonRow>
          </FeatureComparisonTableHeader>
          <FeatureComparisonTableBody>
            {rows.map((row) => (
              <FeatureComparisonRow key={row.id}>
                <FeatureComparisonHead scope="row" className="p-4 font-normal">
                  {row.group && (
                    <span className="mb-2 block font-semibold">
                      {row.group}
                    </span>
                  )}
                  {row.label}
                </FeatureComparisonHead>
                {plans.map((plan) => (
                  <td
                    key={plan.id}
                    className={cn(
                      "p-4",
                      plan.id === highlightedPlan && "bg-muted",
                    )}
                  >
                    {row.values[plan.id] ?? "—"}
                  </td>
                ))}
              </FeatureComparisonRow>
            ))}
          </FeatureComparisonTableBody>
          <tfoot>
            <FeatureComparisonRow>
              <FeatureComparisonCell />
              {plans.map((plan) => (
                <td
                  key={plan.id}
                  className={cn(
                    "p-4",
                    plan.id === highlightedPlan && "bg-muted",
                  )}
                >
                  {plan.action !== undefined ? (
                    plan.action
                  ) : (
                    <Button
                      variant={
                        plan.id === highlightedPlan ? "primary" : "outline"
                      }
                      onClick={() =>
                        onSelect
                          ? onSelect(plan.id)
                          : setMessage(
                              `${plan.id} selected. Demo only; no purchase made.`,
                            )
                      }
                    >
                      Choose {plan.name}
                    </Button>
                  )}
                </td>
              ))}
            </FeatureComparisonRow>
          </tfoot>
        </FeatureComparisonTable>
      ) : (
        children
      )}
    </FeatureComparisonContent>
  );
}
export function FeatureComparisonStatus({
  children,
  ...props
}: Partial<React.ComponentProps<"p">> & { children?: React.ReactNode }) {
  const { message } = useFeatureComparisonComposition();
  return (
    <p role="status" {...props} className={cn("mt-4 text-sm", props.className)}>
      {children === undefined ? message : children}
    </p>
  );
}

export function FeatureComparisonTable({
  className,
  ...props
}: React.ComponentProps<"table">) {
  return (
    <table
      data-slot="feature-comparison-table"
      className={cn(
        "w-full min-w-[540px] border-collapse text-left text-sm",
        className,
      )}
      {...props}
    />
  );
}
export function FeatureComparisonTableHeader({
  className,
  ...props
}: React.ComponentProps<"thead">) {
  return (
    <thead
      data-slot="feature-comparison-tableheader"
      className={cn("", className)}
      {...props}
    />
  );
}
export function FeatureComparisonRow({
  className,
  ...props
}: React.ComponentProps<"tr">) {
  return (
    <tr
      data-slot="feature-comparison-row"
      className={cn("border-b border-border", className)}
      {...props}
    />
  );
}
export function FeatureComparisonHead({
  className,
  ...props
}: React.ComponentProps<"th">) {
  return (
    <th
      data-slot="feature-comparison-head"
      className={cn("p-4", className)}
      {...props}
    />
  );
}
export function FeatureComparisonTableBody({
  className,
  ...props
}: React.ComponentProps<"tbody">) {
  return (
    <tbody
      data-slot="feature-comparison-tablebody"
      className={cn("", className)}
      {...props}
    />
  );
}
export function FeatureComparisonCell({
  className,
  ...props
}: React.ComponentProps<"td">) {
  return (
    <td
      data-slot="feature-comparison-cell"
      className={cn("", className)}
      {...props}
    />
  );
}

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/ui/button.tsx

Scroll horizontally for long lines
"use client";
import * as React from "react";
import { Slot } from "radix-ui";
import { LoaderCircle } from "lucide-react";
import { cn } from "./utils";
export type ButtonProps = React.ComponentProps<"button"> & {
  variant?: "primary" | "secondary" | "outline" | "ghost" | "danger";
  size?: "sm" | "md" | "lg";
  loading?: boolean;
  asChild?: boolean;
};
export function Button({
  variant = "primary",
  size = "md",
  loading,
  asChild,
  className,
  children,
  disabled,
  ...props
}: ButtonProps) {
  const Comp = asChild ? Slot.Root : "button";
  return (
    <Comp
      type={asChild ? undefined : "button"}
      disabled={asChild ? undefined : disabled || loading}
      aria-disabled={disabled || loading || undefined}
      aria-busy={loading || undefined}
      className={cn(
        "relative inline-flex shrink-0 items-center justify-center gap-2 whitespace-nowrap rounded-lg border border-transparent text-sm font-medium leading-none transition-[background-color,border-color,box-shadow,transform] duration-150 focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary active:scale-[.98] disabled:pointer-events-none disabled:opacity-45 aria-disabled:pointer-events-none [&_svg]:shrink-0",
        {
          "bg-primary text-primary-foreground shadow-[inset_0_1px_0_#ffffff26,0_1px_2px_#00000012] hover:bg-primary/90":
            variant === "primary",
          "border-border/60 bg-muted text-foreground hover:bg-muted/70":
            variant === "secondary",
          "border-border bg-background text-foreground shadow-sm hover:bg-muted/60":
            variant === "outline",
          "text-muted-foreground hover:bg-muted hover:text-foreground":
            variant === "ghost",
          "bg-danger text-danger-foreground hover:bg-danger/90":
            variant === "danger",
        },
        {
          "h-8 px-3 text-xs": size === "sm",
          "h-10 px-4": size === "md",
          "h-12 px-6": size === "lg",
        },
        className,
      )}
      {...props}
    >
      {asChild ? (
        children
      ) : (
        <>
          <span
            className={cn(
              "inline-flex min-w-0 flex-1 items-center justify-center gap-2",
              loading && "invisible",
            )}
          >
            {children}
          </span>
          {loading && (
            <LoaderCircle
              aria-hidden="true"
              className="absolute size-4 animate-spin motion-reduce:animate-none"
            />
          )}
        </>
      )}
    </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 →