bigcalendar /react-big-calendar

gcal/outlook like calendar component

★ 8,767⑂ 2,298👁 79⑃ 931● 1,874▤ 137
JavaScriptMITCreated 2015-08-22bigcalendar.github.io/react-big-calendar/
Download: v1.20.0v1.20.0 ↓1.20.02026-06-01
+1
Daily
8,767
stars
2,298
forks
79
watchers
931
prs
1,874
issues
137
releases

README

react-big-calendar

An events calendar component built for React and designed for modern browsers (read: not IE) and uses flexbox over the classic tables-caption approach.


  


DEMO and Docs

Inspired by Full Calendar.

 Use and Setup

yarn add react-big-calendar or npm install --save react-big-calendar

Include react-big-calendar/lib/css/react-big-calendar.css for styles, and make sure your calendar's container
element has a height, or the calendar won't be visible. To provide your own custom styling, see the Custom Styling topic.

 Starters

- react-big-calendar
- react-big-calendar with drag and drop
- react-big-calendar with TypeScript and React hooks bundled with Vite

 Run examples locally

sh
$ git clone [email protected]:bigcalendar/react-big-calendar.git
$ cd react-big-calendar
$ yarn
$ yarn storybook


- Open localhost:9002.

 Localization and Date Formatting

react-big-calendar includes four options for handling the date formatting and culture localization, depending
on your preference of DateTime libraries. You can use either the Moment.js, Globalize.js, date-fns, Day.js localizers.

Regardless of your choice, you must choose a localizer to use this library:

 Moment.js

js
import { Calendar, momentLocalizer } from 'react-big-calendar'
import moment from 'moment'

const localizer = momentLocalizer(moment)

const MyCalendar = (props) = (
  
    
  
)


 Globalize.js v0.1.1

js
import { Calendar, globalizeLocalizer } from 'react-big-calendar'
import globalize from 'globalize'

const localizer = globalizeLocalizer(globalize)

const MyCalendar = (props) = (
  
    
  
)


 date-fns v2

js
import { Calendar, dateFnsLocalizer } from 'react-big-calendar'
import format from 'date-fns/format'
import parse from 'date-fns/parse'
import startOfWeek from 'date-fns/startOfWeek'
import getDay from 'date-fns/getDay'
import enUS from 'date-fns/locale/en-US'

const locales = {
  'en-US': enUS,
}

const localizer = dateFnsLocalizer({
  format,
  parse,
  startOfWeek,
  getDay,
  locales,
})

const MyCalendar = (props) = (
  
    
  
)


 Day.js

Note that the dayjsLocalizer extends Day.js with the following plugins:

- IsBetween
- IsLeapYear
- IsSameOrAfter
- IsSameOrBefore
- LocaleData
- LocalizedFormat
- MinMax
- UTC

js
import { Calendar, dayjsLocalizer } from 'react-big-calendar'
import dayjs from 'dayjs'

const localizer = dayjsLocalizer(dayjs)

const MyCalendar = (props) = (
  
    
  
)


 Custom Styling

Out of the box, you can include the compiled CSS files and be up and running. But, sometimes, you may want to style
Big Calendar to match your application styling. For this reason, SASS files are included with Big Calendar.


  @import 'react-big-calendar/lib/sass/styles';
  @import 'react-big-calendar/lib/addons/dragAndDrop/styles'; // if using DnD


SASS implementation provides a variables file containing color and sizing variables that you can
update to fit your application. _Note:_ Changing and/or overriding styles can cause rendering issues 

Top issues

Latest release

v1.20.0 v1.20.0 2026-06-01
1.20.0 (2026-06-01)


 Bug Fixes

 update node version for runner (2241a1e)


 Features

 update dependencies (5a11b2a)
 update dependencies and more testing (6b65acf)

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON