Sortable header

FREE

A column you can sort by, its natural way first.

Every shadcn style · one file

Installation

pnpm dlx shadcn@latest add https://notchset.dev/r/sortable-header.json

Free, no account or key. One command for every shadcn style. With the @notchset registry added, @notchset/<name> works too.

Works with React 18.3 or 19 on Tailwind CSS v4, in any shadcn project. What's tested

Install by hand

1. Add the packages
pnpm add lucide-react@^1
2. Copy the files to these paths (the source, or save them all as a .zip)
- components/ui/notchset/sortable-header.tsx
3. No stylesheet needed.
4. Install what it builds on first: shadcn's cn helper (lib/utils.ts, from npx shadcn init), the theme foundation (its tokens and base styles)

Styles didn't apply?

The CLI adds the styles to the CSS file named in components.json (tailwind.css). Check that it points at your global stylesheet, that the project uses Tailwind CSS v4, and that the file is imported in your root layout. Installed by hand: paste styles.css into that file.

Usage

Import it and pass your content. The props that matter most are listed next.

Example

"use client";
import * as React from "react";
import { CompanyMark } from "@/components/ui/notchset/company-mark";
import { SortableHeader } from "@/components/ui/notchset/sortable-header";

/* the companies' own marks, 24×24 paths as the CRM seed draws them */
const GLYPH: Record<string, string> = {
  airtable: "M11.992 1.966c-.434 0-.87.086-1.28.257L1.779 5.917c-.503.208-.49.908.012 1.116l8.982 3.558a3.266 3.266 0 0 0 2.454 0l8.982-3.558c.503-.196.503-.908.012-1.116l-8.957-3.694a3.255 3.255 0 0 0-1.272-.257zM23.4 8.056a.589.589 0 0 0-.222.045l-10.012 3.877a.612.612 0 0 0-.38.564v8.896a.6.6 0 0 0 .821.552L23.62 18.1a.583.583 0 0 0 .38-.551V8.653a.6.6 0 0 0-.6-.596zM.676 8.095a.644.644 0 0 0-.48.19C.086 8.396 0 8.53 0 8.69v8.355c0 .442.515.737.908.54l6.27-3.006.307-.147 2.969-1.436c.466-.22.43-.908-.061-1.092L.883 8.138a.57.57 0 0 0-.207-.044z",
  stripe: "M13.976 9.15c-2.172-.806-3.356-1.426-3.356-2.409 0-.831.683-1.305 1.901-1.305 2.227 0 4.515.858 6.09 1.631l.89-5.494C18.252.975 15.697 0 12.165 0 9.667 0 7.589.654 6.104 1.872 4.56 3.147 3.757 4.992 3.757 7.218c0 4.039 2.467 5.76 6.476 7.219 2.585.92 3.445 1.574 3.445 2.583 0 .98-.84 1.545-2.354 1.545-1.875 0-4.965-.921-6.99-2.109l-.9 5.555C5.175 22.99 8.385 24 11.714 24c2.641 0 4.843-.624 6.328-1.813 1.664-1.305 2.525-3.236 2.525-5.732 0-4.128-2.524-5.851-6.594-7.305h.003z",
  revolut: "M20.9133 6.9566C20.9133 3.1208 17.7898 0 13.9503 0H2.424v3.8605h10.9782c1.7376 0 3.177 1.3651 3.2087 3.043.016.84-.2994 1.633-.8878 2.2324-.5886.5998-1.375.9303-2.2144.9303H9.2322a.2756.2756 0 0 0-.2755.2752v3.431c0 .0585.018.1142.052.1612L16.2646 24h5.3114l-7.2727-10.094c3.6625-.1838 6.61-3.2612 6.61-6.9494zM6.8943 5.9229H2.424V24h4.4704z",
  webflow: "m24 4.515-7.658 14.97H9.149l3.205-6.204h-.144C9.566 16.713 5.621 18.973 0 19.485v-6.118s3.596-.213 5.71-2.435H0V4.515h6.417v5.278l.144-.001 2.622-5.277h4.854v5.244h.144l2.72-5.244H24Z",
};

const DEALS = [
  { name: "Airtable", value: 48000, close: "2026-11-07", color: "#18bfff" },
  { name: "Stripe", value: 152000, close: "2026-12-12", color: "#635bff" },
  { name: "Revolut", value: 97500, close: "2026-11-14", color: "#191c1f" },
  { name: "Webflow", value: 214500, close: "2027-01-30", color: "#146ef5" },
];
type Key = "name" | "value" | "close";
/* each column's useful order comes first: names A to Z, money high to low, dates soonest */
const NATURAL: Record<Key, "ascending" | "descending"> = { name: "ascending", value: "descending", close: "ascending" };

export default function SortableHeaderDemo() {
  const [sort, setSort] = React.useState<{ key: Key; flip: boolean }>({ key: "value", flip: false });
  const dir = (k: Key) => (sort.key !== k ? null : sort.flip ? (NATURAL[k] === "ascending" ? "descending" : "ascending") : NATURAL[k]);
  const onSort = (k: Key) => setSort(sort.key === k ? { key: k, flip: !sort.flip } : { key: k, flip: false });
  const rows = [...DEALS].sort((a, b) => (dir(sort.key) === "ascending" ? 1 : -1) * (sort.key === "value" ? a.value - b.value : String(a[sort.key]).localeCompare(String(b[sort.key]))));
  return (
    <table className="w-full max-w-[560px] border-separate border-spacing-0 text-[length:var(--ns-text-body)]">
      <thead className="text-left text-[length:var(--ns-text-meta)] text-[var(--ns-ink-3)] [&_th]:h-10 [&_th]:border-b [&_th]:border-[var(--ns-line)] [&_th]:px-3">
        <tr>
          <SortableHeader label="Company" direction={dir("name")} onSort={() => onSort("name")} />
          <SortableHeader label="Value" align="end" direction={dir("value")} onSort={() => onSort("value")} />
          <SortableHeader label="Close" direction={dir("close")} onSort={() => onSort("close")} />
        </tr>
      </thead>
      <tbody className="[&_td]:h-11 [&_td]:border-b [&_td]:border-[var(--ns-line-soft)] [&_td]:px-3">
        {rows.map((r) => (
          <tr key={r.name}>
            <td>
              <span className="inline-flex items-center gap-2.5">
                <CompanyMark name={r.name} color={r.color} glyph={GLYPH[r.name.toLowerCase()]} />
                {r.name}
              </span>
            </td>
            <td className="text-right tabular-nums">${r.value.toLocaleString("en-US")}</td>
            <td className="text-[var(--ns-ink-2)] tabular-nums">{r.close}</td>
          </tr>
        ))}
      </tbody>
    </table>
  );
}