Ballmac UI home

Calendar

A date grid for one day, several days or a range, with month and year selects, week numbers, disabled rules and range-end styling, on React DayPicker.

7/7 checksv1.0.1Updated Oct 11, 2026Ships with a test
What changed
  1. 1.0.1 Oct 11, 2026React DayPicker reads the current time for today. That now happens inside Suspense, with a same-size placeholder in the prerendered page, so it builds with Cache Components (the Next.js 16.4 default). Pass today to skip the boundary.

Update without losing your edits

Installation

$ pnpm dlx shadcn@latest add @ballmac/calendar

Usage

import { Calendar } from "@/components/ballmac/calendar"

The full example is in the Code tab above.

Examples

Dropdowns and multiple

API reference

PropTypeDefault
bordered

Draw a border, padding and background around the calendar. Turn off inside a popover or card.

booleanfalse

Also accepts the standard attributes of its root element.

Accessibility

KeyAction
Arrow keysMove between days
PageUp / PageDownPrevious or next month; with Shift, previous or next year
Home / EndFirst or last day of the week
Enter / SpaceSelects the focused day

Quality scorecard

7/7

Every applicable check passes

Measured in Chromium 153.0.8010.12 on October 19, 2026, on version 1.0.1, across 2 examples.

How we measure
  • Passed: Accessibility scan

    No serious or critical issues in light and dark, on a phone and a desktop (axe-core 4.13.0, WCAG 2.1 AA and best-practice rules).

  • Passed: Small screens

    No sideways scrolling at 360, 390 or 1280 px wide.

  • Passed: Reduced motion

    No endless animation to begin with.

  • Passed: Right to left

    Mirrors correctly in Arabic, Hebrew, Persian and Urdu layouts (0% of elements off the mirror, limit 15%).

  • Passed: Clean console

    No console errors or React hydration errors while loading.

  • Passed: Keyboard

    11 tab stops, each showing a visible change when it takes focus. 4 documented keys.

  • Not applicable: Loading, empty and error

    Does not show data or take submissions.

  • Passed: Automated tests

    Covered by calendar-prerender.test.tsx, calendar.test.tsx.

  • For information: Footprint

    2.2 KB of source (gzip) in 1 file. Installs react-day-picker, lucide-react.

Automated checks find a subset of problems and do not replace testing with a screen reader and a keyboard in your own app. What they miss.

Use with AI

Use mode single, multiple or range with selected and onSelect. All DayPicker props work: disabled, numberOfMonths, captionLayout dropdown, locale. With the shadcn MCP server set up (guide), ask your agent:

Add the Ballmac UI Calendar (@ballmac/calendar) to this project with the shadcn MCP, then use it where it fits.

Use it for

  • Choosing a date or range inside a card or popover
  • Booking and scheduling
  • Showing availability with disabled days

Not for

  • A date field in a form; use date-picker
  • Typing a range with inputs; use date-range-picker

Registry JSON: https://ui.ballmac.com/r/calendar.json

Credits

Based on shadcn/ui Calendar, adapted by Ballmac. Free to use in personal and commercial projects.

Ballmac UI Pro

Need the whole screen, not one piece?

311 premium blocks (dashboards, settings, calendars, mail, shops, onboarding), a private shadcn registry and Figma tokens. Blocks that show data come with loading, empty and error states built in.

Not ready? Try three Pro blocks free

Leave your email and the blocks appear right here, ready to copy. Yours to use in any project.