Calendar
Freev1.0.0The shadcn Calendar with week numbers, event dots and range selection.
Build for your project
Code/install build
Usage
Import it and pass your content. The props that matter most are listed next.
Example
"use client";
import * as React from "react";
import { Calendar } from "@/components/ui/notchset/calendar";
/** Days with scheduled evals, keyed YYYY-MM-DD. */
const evals = { "2026-10-06": ["Planner core"], "2026-10-09": ["Citations", "Safety"] };
// `today` comes from the server (the request's date), so server and browser render the same month.
export function EvalCalendar({ today }: { today: Date }) {
const [day, setDay] = React.useState<Date | undefined>(today);
return <Calendar mode="single" selected={day} onSelect={setDay} events={evals} showWeekNumber showToday />;
}Props
mode–"single" | "range"One day, or a range (from, to).
selected / onSelect–Date | DateRangeControlled, as shadcn's.
month / onMonthChange–DateThe month shown.
disabled–(date) => booleanDays that can't be picked.
startMonth / endMonth–DateHow far the arrows go.
events–Record<YYYY-MM-DD, string[]>Up to three dots a day, counted in its label.
Show all 8 propsShow fewer
showWeekNumber / showToday–booleanISO weeks; a TODAY link.
size–"default" | "sm"44px or 40px days.
Anatomy
- Same API as shadcn's Calendar (mode, selected, onSelect, month, disabled).
- No primitive needed: one file serves both builds.
- Date Picker and Date Range Picker share its grid.
Calendardata-slot="calendar"The framed grid.
—data-slot="calendar-grid"The header, weekdays and days.
—data-slot="calendar-block"The selection block.
Source
components/ui/notchset/calendar.tsx
Loading the code
Build for your project
Code/install build
Installation
Base UI
pnpm dlx shadcn@latest add https://notchset.dev/r/calendar.jsonRadix
pnpm dlx shadcn@latest add https://notchset.dev/r/radix-nova/calendar.jsonFree, no account or key. Use the command for your project's primitives: a radix-*, new-york or default style in components.json is Radix, a base-* style is Base UI. With the @notchset registry added, @notchset/<name> picks for you.
Install by hand
- 1. No extra packages: React and Tailwind CSS v4 are enough.
- 2. Copy the files to these paths (the source, or save them all as a .zip)
- components/ui/notchset/calendar.tsx
- lib/beautiful-ui/notchset/calendar.tsx
- lib/beautiful-ui/notchset/instrument.tsx
- lib/beautiful-ui/notchset/root.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)
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.
For coding agents
Give your coding assistant the Markdown guide instead of screenshots.
Use it for
- Showing a month with a picked day, and what happens on each day
- Picking a range inline, on a page
Use something else when
- A date in a form: use Date Picker
- A range with presets and typed dates: use Date Range Picker
Mistakes to avoid
- Events are keyed by local YYYY-MM-DD
Agents find it by
- calendar, date grid, schedule, month view, event calendar, range calendar, shadcn calendar, Notchset
Where agents read it
- Guide for this component: https://notchset.dev/md/calendar.md
- Every component, for tools without MCP: /llms.txt
- MCP server:
https://notchset.dev/api/mcp(setup)
Behaviour
Keyboard
- ← → ↑ ↓
- Day / week
- Home / End
- Week start / end
- PgUp / PgDn
- Month
- Enter / Space
- Pick
Accessibility
- A grid of rows of gridcells with roving tabindex; each day's label says its date, today and its events
- The month title is announced when it changes; disabled days are aria-disabled
Motion
- Pick
- The ink block stretches: the leading edge moves first, the trailing edge 85ms later (300ms); the number turns paper 140ms in
- Month
- The grid fades and slides 14px away (110ms), then settles in from the other side (380ms); the title rolls 8px
- Range
- The fill ripples out from the start, 10ms a day
Responsive
- Fixed width: 7 × 44px (+34px week column). Use size="sm" on narrow screens.
Performance
- 42 buttons and CSS transitions; one block moves, not 42 cells.
Changelog
v1.0.0 · 2026-10-02
First release
