# Appointment Planner block

> Schedule with date-picker calendar and filterable day agenda of status events

Two-pane schedule: a month Calendar with event dots beside a status-filterable day agenda of event cards with status Badge, attendee AvatarGroup, time and location. ReUI Frame, Badge plus shadcn Calendar, Select, Avatar. Planner, appointments.

- Type: Pro block
- Category: [Schedule](https://web.dev.reui.io/blocks/application/schedule.md)
- Page: https://web.dev.reui.io/blocks/application/schedule/schedule-1
- MCP: `get_block("schedule-1")`
- Built with: Avatar, Badge, Button, Calendar, Frame, Item, Popover, Scroll Area, Select
- Installs with a ReUI Pro or Ultimate license; setup: https://web.dev.reui.io/docs/license-setup

## Best for

A month calendar beside a day agenda filtered by Upcoming, Pending, Completed or Cancelled, with a location on each event

## Agent notes

- `MOCK_EVENTS` is generated by `buildMockEvents` around the fixed `DEMO_REFERENCE_DATE`; replace both with events from your API
- The Add button in `EventsList` has no click handler and each `EventCard` title is a bare hash link; wire both to your own pages

## When not to use

- Events that people create, move and resize by dragging on a grid: use [Personal Calendar](https://web.dev.reui.io/blocks/application/event-calendar/event-calendar-1.md) (`get_block("event-calendar-1")`)
- One meeting is booked from a slot list with a repeat rule and notes: use [Meeting Scheduler](https://web.dev.reui.io/blocks/application/schedule/schedule-3.md) (`get_block("schedule-3")`)

## Third-party libraries

- React DayPicker v9: [API reference](https://daypicker.dev/v9/api), [docs](https://daypicker.dev/v9/start)

## Install

```bash
npx shadcn@latest add @reui/schedule-1
```

## About Schedule blocks

### When to use

- Booking a session or setting up a meeting: a day, a time slot, a duration and a confirm step
- A month view card with the picked day's events and attendees, or a team's attendance counts
- Creating a scheduled event with members and files, or an event's detail card with an RSVP

### When not to use

- A full page week or month grid where people drag, resize and create events: use the [Event Calendar blocks](https://web.dev.reui.io/blocks/application/event-calendar.md)
- A plain day or range field in a form, with no slots, agenda or booking card: use [Calendar](https://web.dev.reui.io/components/calendar.md) (`get_component("calendar")`)
- A drop zone for attachments on its own, with no booking or meeting fields: use [File Upload](https://web.dev.reui.io/components/file-upload.md) (`get_component("file-upload")`)

### Agent notes

- `Schedule` takes no props and saves or sends nothing; add a callback to hand the picked day, time or form values to your app
- Each `Schedule` caps its width with a max-w class on its root `Frame`, and page.tsx centers it with p-10 md:p-20; drop both inside your layout

Every ReUI item has a twin like this one; the index is https://web.dev.reui.io/llms.txt. Agents with the ReUI MCP (https://web.dev.reui.io/docs/mcp) get the same guidance from the getters named above.