---
title: "Event Calendar | Free React & Tailwind Blocks Component | Motion UI"
canonical: "https://blacknest.dev/motion/c/blocks/event-calendar"
github_source: "https://github.com/Rkj0123/motion-ui-skill/blob/main/components/motion/event-calendar.tsx"
install_command: "npx motion-ui-skill add event-calendar"
dependencies: ["clsx","lucide-react","motion","react","tailwind-merge"]
category: "blocks"
subcategory: "motion"
---

# Event Calendar

> Headless-first animated event calendar with monthly grid views, event pills, day-switching transitions, and modal detail inspection. Inspired by KeenThemes ReUI.

## Install

```bash
npx motion-ui-skill add event-calendar
```

## Dependencies

- `clsx`
- `lucide-react`
- `motion`
- `react`
- `tailwind-merge`

## Usage

```tsx
"use client";

import { EventCalendar, type CalendarEvent } from "@/components/motion/event-calendar";

const EVENTS: CalendarEvent[] = [
  {
    id: "e1",
    title: "Quarterly Roadmap Review",
    date: "2026-09-12",
    time: "10:00",
    color: "blue",
  },
  {
    id: "e2",
    title: "Model Release Deploy",
    date: "2026-09-15",
    time: "14:30",
    color: "emerald",
  },
  {
    id: "e3",
    title: "Security Penetration Audit",
    date: "2026-09-22",
    color: "rose",
  },
];

export function EventCalendarExample() {
  return (
    <div className="max-w-3xl p-6">
      <EventCalendar
        events={EVENTS}
        onEventClick={(ev) => console.log("Event clicked:", ev.title)}
      />
    </div>
  );
}
```

## Props

| Prop | Type | Default | Description |
| :--- | :--- | :--- | :--- |
| `events` | `CalendarEvent[]` | required | Array of scheduled events with id, title, ISO date string, time, and color tag. |
| `initialDate` | `Date` | `new Date()` | Initial month/year viewing anchor. |
| `onEventClick` | `(event: CalendarEvent) => void` | `undefined` | Callback emitted when an event pill is selected. |
| `onDateClick` | `(date: Date) => void` | `undefined` | Callback emitted when a day cell is clicked. |
| `className` | `string` | `undefined` | Custom styling overrides merged via `cn()`. |

## Source Files

- [components/motion/event-calendar.tsx](https://github.com/Rkj0123/motion-ui-skill/blob/main/components/motion/event-calendar.tsx)
- [lib/ease.ts](https://github.com/Rkj0123/motion-ui-skill/blob/main/lib/ease.ts)
- [lib/hooks/use-dismiss.ts](https://github.com/Rkj0123/motion-ui-skill/blob/main/lib/hooks/use-dismiss.ts)
- [lib/hooks/use-haptic.ts](https://github.com/Rkj0123/motion-ui-skill/blob/main/lib/hooks/use-haptic.ts)
- [lib/utils.ts](https://github.com/Rkj0123/motion-ui-skill/blob/main/lib/utils.ts)
