React DayPicker
DayPicker is a React component for creating date pickers, calendars, and date inputs for web applications.
You are reading the README for react-day-picker, the legacy DayPicker package name. It remains available for compatibility and exposes the same DayPicker API in v10, but new projects should use @daypicker/react.
Documentation
See daypicker.dev for guides, examples, and API reference, or read the v10 docs in the repository .
Features
🛠 Extensive set of props for customizing the calendar.
🎨 Minimal design that can be easily styled with CSS or any CSS framework.
📅 Supports selections of single days, multiple days, ranges of days, or custom selections .
🌍 Can be localized into any language and .
DayPicker is written in TypeScript and compiled to CommonJS and ESM. It relies on date-fns for date manipulation and formatting.
Installation
Install the legacy DayPicker package name:
npm install react-day-picker copy
For new projects, prefer the @daypicker/react package name:
npm install @daypicker/react copy
Example
import { useState } from "react" ;
import { DayPicker } from "react-day-picker" ;
import "react-day-picker/style.css" ;
function MyDatePicker () {
const [selected, setSelected] = useState < Date >();
return (
< DayPicker
mode= "single"
selected={ selected }
onSelect={ setSelected }
footer={
selected ? `Selected: ${ selected . toLocaleDateString () }` : "Pick a day."
}
/>
);
}
Compatibility
DayPicker is compatible with React 16.8 and later.
License
DayPicker is released under the MIT License .
Ask for help and share your experience with DayPicker:
💬 Discussion forums - Get support and provide feedback.
🪳 Report an issue - Report bugs or request features.
Thank you to everyone supporting DayPicker - your sponsorship keeps this project maintained and evolving.