gitmyhub

react-native-calendars

TypeScript ★ 10k updated 1mo ago

React Native Calendar Components 🗓️ 📆

A React Native library by Wix that gives iOS and Android apps ready-made calendar screens, monthly grids, date selection, range highlighting, and an agenda view, without writing them from scratch.

TypeScriptJavaScriptReact Nativesetup: easycomplexity 2/5

React Native Calendars is a library of calendar and date-picker components for mobile apps built with React Native, which is a framework for creating iOS and Android apps using JavaScript. The library is made by Wix, the website-building company, and published as open-source for other developers to use.

Adding this library to a project gives you ready-made calendar screens without having to draw them from scratch. The calendar shows a monthly grid of dates, and you can let users tap a day to select it, mark specific dates with dots or colored highlights, block certain dates from being selectable, or show a range of days as a highlighted period. There is also an agenda view that combines the calendar with a scrollable list of events below it.

The library is written entirely in JavaScript, so it does not require any platform-specific native code to be compiled or linked. That makes it easier to add to a project, including projects using Expo, a popular tool for building React Native apps without complex setup.

Developers can change the visual appearance of the calendar by passing in color and font settings. Day names and month names can be replaced with translations in any language, so the calendar can display in French, Arabic, or any other locale the app needs.

Installation is a single package manager command. The README walks through basic examples for displaying a calendar, marking dates, setting a starting date, and applying a custom color theme. Full documentation lives on a separate website linked from the README.

The project welcomes contributions and asks contributors to run the test and lint checks before submitting a pull request.

Where it fits