Side panel

FREE

A record beside its list; J and K step through.

Every shadcn style · one file

Installation

pnpm dlx shadcn@latest add https://notchset.dev/r/side-panel.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 @base-ui/react@^1 lucide-react@^1
2. Copy the files to these paths (the source, or save them all as a .zip)
- components/ui/notchset/side-panel.tsx
- lib/notchset/portal.ts
- lib/notchset/return-focus.ts
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), Breadcrumb and back, Icon button

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 { Building2 } from "lucide-react";
import { Button } from "@/components/ui/notchset/button";
import { CompanyMark } from "@/components/ui/notchset/company-mark";
import { SidePanel } from "@/components/ui/notchset/side-panel";

/* 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",
};

const DEALS = [
  { name: "Airtable", value: "$48,000", close: "Nov 7", color: "#18bfff" },
  { name: "Stripe", value: "$152,000", close: "Dec 12", color: "#635bff" },
  { name: "Revolut", value: "$97,500", close: "Nov 14", color: "#191c1f" },
];

export default function SidePanelDemo() {
  const [at, setAt] = React.useState<number | null>(null);
  const d = DEALS[at ?? 0]!;
  return (
    <>
      <Button onClick={() => setAt(0)}>
        <Building2 />
        Open Airtable
      </Button>
      <SidePanel
        open={at !== null}
        onOpenChange={(o) => !o && setAt(null)}
        kind="Company"
        title={d.name}
        position={`${(at ?? 0) + 1} of ${DEALS.length}`}
        onPrevious={at ? () => setAt(at - 1) : undefined}
        onNext={at !== null && at < DEALS.length - 1 ? () => setAt(at + 1) : undefined}
      >
        <div className="flex items-center gap-3">
          <CompanyMark name={d.name} color={d.color} glyph={GLYPH[d.name.toLowerCase()]} size={40} />
          <div className="flex flex-col gap-1">
            <b className="text-[length:var(--ns-text-title)] font-[number:var(--ns-weight-strong)]">{d.name}</b>
            <span className="text-[var(--ns-ink-3)]">
              {d.value} · closes {d.close}
            </span>
          </div>
        </div>
        <p className="m-0 text-[var(--ns-ink-3)]">Press J or K to step through the list without closing the panel.</p>
      </SidePanel>
    </>
  );
}

This example also uses Company mark. This command installs them with it, so the example pastes as it is:

pnpm dlx shadcn@latest add https://notchset.dev/r/side-panel.json https://notchset.dev/r/company-mark.json

Anatomy

Built fromBreadcrumb and back Icon buttonPortalFocus return

Source

components/ui/notchset/side-panel.tsx

Props

open–
boolean
Required.
onOpenChange–
(open: boolean) => void
Required.
title–
React.ReactNode
Required.
kind–
string
A quiet word before the title ("Company", "Task").
position–
string
Where the record sits in the list on screen ("3 of 12"); quiet, after the kind, not on a phone.
onPrevious–
() => void

Show all 10 props

onNext–
() => void
back–
{ label: string; onBack: () => void }
Shown after following a link inside the panel: where Back goes. Hides the list arrows.
actions–
React.ReactNode
width–
string
A wider panel for a record that is written in (a task with its thread): a CSS length, "600px".