Week calendarPro
A week calendar where you drag to create, move, and resize events, with color coded calendars, day and agenda views, and swipes on phones.
Live block · sample data
- Scheduling and planning screens where people create, move and resize time blocks across a week.
- Team or personal calendars that need several color coded calendars, all day events and an agenda on phones.
- Use month-calendar for a month overview with events per day.
- Use calendar or date-picker to pick a date, and time-picker for a single time.
- Use availability-picker to collect open slots from someone.
Installation
Pro source and install commands unlock with a Pro plan.
Usage
Use this for scheduling and planning views. Pass your events and calendars, and persist changes in onCreate, onUpdate, and onDelete.
example.tsx
import { useState } from "react";import { WeekCalendar, type CalendarEvent } from "@/registry/blocks/week-calendar/week-calendar"; const calendars = [ { id: "work", name: "Work", color: "blue" }, { id: "personal", name: "Personal", color: "green" },]; export default function SchedulePage({ initial }: { initial: CalendarEvent[] }) { const [events, setEvents] = useState(initial); return ( <WeekCalendar events={events} onEventsChange={setEvents} calendars={calendars} onCreate={event => api.create(event)} onUpdate={event => api.update(event)} onDelete={event => api.remove(event.id)} startHour={6} timeZone="America/Los_Angeles" /> );}Built fromMotion
WeekCalendar
A week calendar at the level of a native app: week, work week and day views on wide screens, three days and an agenda list on phones, a mini month and calendar toggles in a sidebar when there is room, and an all day row that collapses when it fills up. Drag on empty time to draw an event and name it in a quick create popover, drag events between days and times, stretch the bottom edge to resize, and click an event to edit its title, day, time and calendar; everything snaps to 15 minutes. Events can be controlled or uncontrolled; without events it shows a realistic sample week.
PropTypeDefaultDescription
eventsCalendarEvent[]–Controlled events: { id, title, start: Date, end: Date, calendarId, allDay?, location?, attendees? }. Pair with onEventsChange.defaultEventsCalendarEvent[]–Starting events when uncontrolled. Without events or defaultEvents the calendar shows the sample week from week-calendar-data.ts.onEventsChange(events: CalendarEvent[]) => void–Called with the full list after every change: create, move, resize, edit, delete and undo.onCreate(event: CalendarEvent) => void–Called when someone saves a new event, and when an undo restores a deleted one.onUpdate(event: CalendarEvent, previous: CalendarEvent) => void–Called after a move, resize or edit in the details popover, with the event before the change.onDelete(event: CalendarEvent) => void–Called when an event is deleted. The undo toast calls onCreate if the person restores it.calendarsCalendarSource[]SAMPLE_CALENDARSCalendars as { id, name, color, hidden? }. color is blue, green, violet, amber, rose, teal or any CSS color; built in names are tuned for light and dark.defaultDateDate–The day to open on. Defaults to today, or to the sample week when showing sample events.defaultView"week" | "workweek" | "day" | "3day" | "agenda""week"Starting view. Below a 640px container week views show three days, and agenda is offered instead of work week.onViewChange(view: CalendarView) => void–Called when the view changes.weekStartsOn0 | 1 | 2 | 3 | 4 | 5 | 61First day of the week; 0 is Sunday.startHournumber0First hour shown in the day grid.endHournumber24Hour the day grid ends at.timeZonestring–IANA zone the grid runs in, such as "America/New_York". Times are converted and formatted with Intl. Defaults to the browser's zone.localestring"en-US"Locale for dates and times.classNamestring–Class for the root element. Set --calendar-height on it to change the height of the scrolling grid.- Arrow leftorArrow right
- Moves between days; past the edge of the range, the next week or days slide in.
- T
- Goes to today.
- N
- Drafts a new event at the next free hour of the focused day and opens the quick create form.
- Enter
- Saves the quick create form, opens a focused event, or drafts an event on a focused day.
- DeleteorBackspace
- Deletes the focused or selected event, with an undo toast.
- Escape
- Closes a popover, cancels a drag, or clears the selection.
- DorW
- Switches to the day or week view.
- Arrow uporArrow down
- On an event, moves focus to the previous or next event.
- Alt+Arrow keys
- Moves the focused event by a day or 15 minutes; add Shift with up and down to change its length.
- CmdorCtrl+Z
- Undoes the last move, resize, time change or delete.
- Each range is a role="grid" labelled with its dates and described by screen reader instructions; every day is a labelled grid cell with its date and event count, and keyboard focus moves between them with the arrow keys.
- Events are buttons whose labels read the title, full date, start and end time, calendar and location; all day events and agenda rows follow the same pattern.
- The quick create form and event details are labelled dialogs that take focus, close on Escape or a press outside, and return focus to the event.
- A polite live region announces range changes, creates, moves, resizes, deletes and undos. No focus rings: focus shows the same fill as hover.
- Ranges slide in the direction of travel on a spring without overshoot, the header and all day row move with the grid, and a swipe on touch drags the neighbors along so letting go continues without a seam.
- Events animate to new positions with transforms only: a dragged event hops between 15 minute slots, and neighbors settle into their new columns after a drop or an edit.
- Popovers scale in from the edge that faces their event; the undo toast rises from the bottom.
- Reduced motion replaces slides and position springs with instant moves and short fades.
- From a 1100px container a sidebar adds a mini month and calendar toggles; narrower, the toggles move into a Calendars popover.
- Between 640px and 900px the gutter and dates tighten and event blocks drop details that no longer fit, using container queries on each event.
- Below 640px the week becomes three days with Day and Agenda views, horizontal swipes change days, and a long press starts creating or moving so vertical swipes still scroll.
- The grid scrolls inside a height of clamp(480px, 72vh, 760px); set --calendar-height on the root to change it.
- Event blocks are memoized on primitive props, so a drag re-renders only the event that moves; position changes animate with transforms, never layout.
- Time zone conversion runs once per events change; the now line updates on each minute boundary.
- All events are plain DOM; for thousands of events per week, pass only the visible range.
Notes for AI
Give your coding assistant the Markdown reference instead of screenshots.
- Use for scheduling and planning screens where people create and rearrange time blocks; pass events and persist in onCreate, onUpdate and onDelete.
- Event times are Date instants. The grid shows them in timeZone (or the browser's zone), so store UTC and let the calendar format them.
- Map your calendars to calendars with a color each; hidden calendars start toggled off in the calendar list.
- sampleEvents() and SAMPLE_CALENDARS in week-calendar-data.ts are demo content to remove.
The full library index for assistants is at /llms.txt.