Skip to main content

Prerequisites

A React Native app on the new architecture, with these peer dependencies installed: react-native-reanimated (v4), react-native-gesture-handler, react-native-worklets, and @legendapp/list (v3). The Expo SDK includes compatible versions.

Install

1

Add the package and peers

2

Wrap your app in GestureHandlerRootView

Gesture Handler needs a root view at the top of your tree.
3

Render a calendar

<Calendar> is controlled: you own date and events, and update them from its callbacks.
Targeting the web too? See the Web guide for the extra peers and how the touch gestures map to mouse and keyboard.

Next steps

Custom events

Type your events and render them your way.

Dragging & creating

Turn on move, resize, and drag-to-create.

Views

Month, week, day, 3-day, and schedule.

Theming

Colors, dark mode, and business hours.

Migrating from big-calendar

A copy-paste agent prompt and prop mapping.