Join our Discord community
Time

Mini Calendar

Compact date picker component for React and Next.js applications. Built with TypeScript support, Tailwind CSS styling, and shadcn/ui design featuring horizontal layout, navigation controls, and accessibility features.

Powered by

Loading component...

Installation

npx shadcn@latest add https://www.shadcn.io/registry/mini-calendar.json
npx shadcn@latest add https://www.shadcn.io/registry/mini-calendar.json
pnpm dlx shadcn@latest add https://www.shadcn.io/registry/mini-calendar.json
bunx shadcn@latest add https://www.shadcn.io/registry/mini-calendar.json

Features

  • Horizontal layout - Configurable consecutive days display (default: 5) using Tailwind CSS flex
  • Navigation controls - Chevron buttons for date range movement using JavaScript event handlers
  • Composable design - Separate components for navigation, container, and days using React composition
  • Controlled/uncontrolled - Flexible state management with value and onChange props for Next.js applications
  • Today highlighting - Accent background for current date with button variant styling using TypeScript
  • Accessibility features - Semantic HTML and ARIA attributes using shadcn/ui patterns
  • Context management - Component state sharing through React Context for date-fns integration
  • Open source - Free mini calendar with Lucide icons and customizable styling

Examples

Basic Usage

Loading component...

Controlled

Loading component...

Custom Layout

Loading component...

Custom Days

Loading component...

Use Cases

  • Quick date selection - Recent date picking for forms and scheduling
  • Dashboard widgets - Compact calendar controls in admin interfaces
  • Event creation - Near-term date selection for appointments and tasks
  • Timeline navigation - Date-based content filtering and browsing

Implementation

Built with date-fns for date calculations. Uses React Context for component communication. Supports controlled and uncontrolled modes. Lucide icons for navigation with semantic HTML.