# wix/react-native-calendars architecture

> Architecture diagram of the GitHub repository wix/react-native-calendars, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/wix/react-native-calendars
- Repository: https://github.com/wix/react-native-calendars

## Overview

React Native Calendars is a JavaScript component library for displaying and interacting with dates on iOS and Android. Its main workflow exposes calendar components to an app, renders selectable and marked dates, and optionally connects calendar navigation to agendas or event timelines. The graph also captures date handling and shared list infrastructure. README claims cover customization, localization, accessibility, and marking variants; these are capabilities of the components, not separate services. Unsampled modules are included by their tree paths, but their internal relationships are omitted where the excerpts and index do not establish them.

Main entry points: [`src/index.ts`](https://github.com/wix/react-native-calendars/blob/master/src/index.ts) (Component exports), [`src/calendar/index.tsx`](https://github.com/wix/react-native-calendars/blob/master/src/calendar/index.tsx) (Month calendar), [`src/agenda/index.tsx`](https://github.com/wix/react-native-calendars/blob/master/src/agenda/index.tsx) (Agenda calendar), [`src/calendar-list/index.tsx`](https://github.com/wix/react-native-calendars/blob/master/src/calendar-list/index.tsx) (Scrollable calendar)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Library API"]
  node_exports["Component exports<br/>[index.ts]"]
end

subgraph group_calendar["Calendar Views"]
  node_calendar["Month calendar<br/>[index.tsx]"]
  node_day["Day rendering<br/>[index.tsx]"]
  node_markings["Day markings<br/>[index.tsx]"]
  node_header["Calendar header<br/>[index.tsx]"]
  node_calendarlist["Scrollable calendar<br/>[index.tsx]"]
  node_calendarlistnew["Infinite calendar<br/>[new.tsx]"]
  node_weekcalendar["Week calendar<br/>[index.tsx]"]
  node_expandable["Expandable calendar<br/>[index.tsx]"]
end

subgraph group_agenda["Agenda Views"]
  node_agenda["Agenda calendar<br/>[index.tsx]"]
  node_reservations["Reservation list<br/>[index.tsx]"]
  node_agendalist["Agenda list<br/>[agendaList.tsx]"]
  node_timeline["Timeline view<br/>[Timeline.tsx]"]
  node_timelinelist["Timeline list<br/>[index.tsx]"]
end

subgraph group_shared["Shared Runtime"]
  node_dateutils["Date operations<br/>[dateutils.ts]"]
  node_dateinterface["Date conversion<br/>[interface.ts]"]
  node_services["Locale services<br/>[index.ts]"]
  node_infinitelist["Infinite list<br/>[index.tsx]"]
  node_context["Calendar context<br/>[index.ts]"]
  node_updater["Prop update helpers"]
end

node_app(("React Native app"))

node_app -->|"imports"| node_exports
node_exports -->|"exports"| node_calendar
node_exports -->|"exports"| node_calendarlist
node_exports -->|"exports"| node_calendarlistnew
node_exports -->|"exports"| node_agenda
node_exports -->|"exports"| node_expandable
node_exports -->|"exports"| node_weekcalendar
node_exports -->|"exports"| node_agendalist
node_exports -->|"exports"| node_timeline
node_exports -->|"exports"| node_timelinelist
node_calendar -->|"renders"| node_day
node_calendar -->|"renders"| node_header
node_day -->|"uses marking"| node_markings
node_calendarlist -->|"renders months"| node_calendar
node_calendarlist -->|"uses header"| node_header
node_calendarlistnew -->|"renders months"| node_calendar
node_calendarlistnew -->|"uses list"| node_infinitelist
node_agenda -->|"controls scrolling"| node_calendarlist
node_agenda -->|"renders"| node_reservations
node_expandable -->|"renders"| node_calendar
node_expandable -->|"renders"| node_weekcalendar
node_weekcalendar -->|"reads context"| node_context
node_agendalist -->|"reads context"| node_context
node_timelinelist -->|"renders pages"| node_timeline
node_timelinelist -->|"uses list"| node_infinitelist
node_timeline -->|"uses locale"| node_services
node_calendar -->|"uses dates"| node_dateutils
node_calendar -->|"converts dates"| node_dateinterface
node_agenda -->|"compares dates"| node_dateutils
node_agendalist -->|"uses dates"| node_dateutils
node_calendarlist -->|"extracts props"| node_updater
node_agenda -->|"updates props"| node_updater

click node_exports "https://github.com/wix/react-native-calendars/blob/master/src/index.ts"
click node_calendar "https://github.com/wix/react-native-calendars/blob/master/src/calendar/index.tsx"
click node_day "https://github.com/wix/react-native-calendars/blob/master/src/calendar/day/index.tsx"
click node_markings "https://github.com/wix/react-native-calendars/blob/master/src/calendar/day/marking/index.tsx"
click node_header "https://github.com/wix/react-native-calendars/blob/master/src/calendar/header/index.tsx"
click node_calendarlist "https://github.com/wix/react-native-calendars/blob/master/src/calendar-list/index.tsx"
click node_calendarlistnew "https://github.com/wix/react-native-calendars/blob/master/src/calendar-list/new.tsx"
click node_weekcalendar "https://github.com/wix/react-native-calendars/blob/master/src/expandableCalendar/WeekCalendar/index.tsx"
click node_expandable "https://github.com/wix/react-native-calendars/blob/master/src/expandableCalendar/index.tsx"
click node_agenda "https://github.com/wix/react-native-calendars/blob/master/src/agenda/index.tsx"
click node_reservations "https://github.com/wix/react-native-calendars/blob/master/src/agenda/reservation-list/index.tsx"
click node_agendalist "https://github.com/wix/react-native-calendars/blob/master/src/expandableCalendar/AgendaList/agendaList.tsx"
click node_timeline "https://github.com/wix/react-native-calendars/blob/master/src/timeline/Timeline.tsx"
click node_timelinelist "https://github.com/wix/react-native-calendars/blob/master/src/timeline-list/index.tsx"
click node_dateutils "https://github.com/wix/react-native-calendars/blob/master/src/dateutils.ts"
click node_dateinterface "https://github.com/wix/react-native-calendars/blob/master/src/interface.ts"
click node_services "https://github.com/wix/react-native-calendars/blob/master/src/services/index.ts"
click node_infinitelist "https://github.com/wix/react-native-calendars/blob/master/src/infinite-list/index.tsx"
click node_context "https://github.com/wix/react-native-calendars/blob/master/src/expandableCalendar/Context/index.ts"
click node_updater "https://github.com/wix/react-native-calendars/blob/master/src/componentUpdater.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_exports toneBlue
class node_calendar,node_day,node_markings,node_header,node_calendarlist,node_calendarlistnew,node_weekcalendar,node_expandable toneAmber
class node_agenda,node_reservations,node_agendalist,node_timeline,node_timelinelist toneMint
class node_dateutils,node_dateinterface,node_services,node_infinitelist,node_context,node_updater toneRose
class node_app toneIndigo
```

## Components

### Library API

- [Component exports](https://github.com/wix/react-native-calendars/blob/master/src/index.ts): `src/index.ts`

### Calendar Views

- [Month calendar](https://github.com/wix/react-native-calendars/blob/master/src/calendar/index.tsx): `src/calendar/index.tsx`
- [Day rendering](https://github.com/wix/react-native-calendars/blob/master/src/calendar/day/index.tsx): `src/calendar/day/index.tsx`
- [Day markings](https://github.com/wix/react-native-calendars/blob/master/src/calendar/day/marking/index.tsx): `src/calendar/day/marking/index.tsx`
- [Calendar header](https://github.com/wix/react-native-calendars/blob/master/src/calendar/header/index.tsx): `src/calendar/header/index.tsx`
- [Scrollable calendar](https://github.com/wix/react-native-calendars/blob/master/src/calendar-list/index.tsx): `src/calendar-list/index.tsx`
- [Infinite calendar](https://github.com/wix/react-native-calendars/blob/master/src/calendar-list/new.tsx): `src/calendar-list/new.tsx`
- [Week calendar](https://github.com/wix/react-native-calendars/blob/master/src/expandableCalendar/WeekCalendar/index.tsx): `src/expandableCalendar/WeekCalendar/index.tsx`
- [Expandable calendar](https://github.com/wix/react-native-calendars/blob/master/src/expandableCalendar/index.tsx): `src/expandableCalendar/index.tsx`

### Agenda Views

- [Agenda calendar](https://github.com/wix/react-native-calendars/blob/master/src/agenda/index.tsx): `src/agenda/index.tsx`
- [Reservation list](https://github.com/wix/react-native-calendars/blob/master/src/agenda/reservation-list/index.tsx): `src/agenda/reservation-list/index.tsx`
- [Agenda list](https://github.com/wix/react-native-calendars/blob/master/src/expandableCalendar/AgendaList/agendaList.tsx): `src/expandableCalendar/AgendaList/agendaList.tsx`
- [Timeline view](https://github.com/wix/react-native-calendars/blob/master/src/timeline/Timeline.tsx): `src/timeline/Timeline.tsx`
- [Timeline list](https://github.com/wix/react-native-calendars/blob/master/src/timeline-list/index.tsx): `src/timeline-list/index.tsx`

### Shared Runtime

- [Date operations](https://github.com/wix/react-native-calendars/blob/master/src/dateutils.ts): `src/dateutils.ts`
- [Date conversion](https://github.com/wix/react-native-calendars/blob/master/src/interface.ts): `src/interface.ts`
- [Locale services](https://github.com/wix/react-native-calendars/blob/master/src/services/index.ts): `src/services/index.ts`
- [Infinite list](https://github.com/wix/react-native-calendars/blob/master/src/infinite-list/index.tsx): `src/infinite-list/index.tsx`
- [Calendar context](https://github.com/wix/react-native-calendars/blob/master/src/expandableCalendar/Context/index.ts): `src/expandableCalendar/Context/index.ts`
- [Prop update helpers](https://github.com/wix/react-native-calendars/blob/master/src/componentUpdater.ts): `src/componentUpdater.ts`

### Other components

- **React Native app**

## Connections

- React Native app → Component exports: imports (evidence: `README.md`)
- Component exports → Month calendar: exports (evidence: `src/index.ts`)
- Component exports → Scrollable calendar: exports (evidence: `src/index.ts`)
- Component exports → Infinite calendar: exports (evidence: `src/index.ts`)
- Component exports → Agenda calendar: exports (evidence: `src/index.ts`)
- Component exports → Expandable calendar: exports (evidence: `src/index.ts`)
- Component exports → Week calendar: exports (evidence: `src/index.ts`)
- Component exports → Agenda list: exports (evidence: `src/index.ts`)
- Component exports → Timeline view: exports (evidence: `src/index.ts`)
- Component exports → Timeline list: exports (evidence: `src/index.ts`)
- Month calendar → Day rendering: renders (evidence: `src/calendar/index.tsx`)
- Month calendar → Calendar header: renders (evidence: `src/calendar/index.tsx`)
- Day rendering → Day markings: uses marking
- Scrollable calendar → Month calendar: renders months (evidence: `src/calendar-list/index.tsx`)
- Scrollable calendar → Calendar header: uses header (evidence: `src/calendar-list/index.tsx`)
- Infinite calendar → Month calendar: renders months (evidence: `src/calendar-list/new.tsx`)
- Infinite calendar → Infinite list: uses list (evidence: `src/calendar-list/new.tsx`)
- Agenda calendar → Scrollable calendar: controls scrolling (evidence: `src/agenda/index.tsx`)
- Agenda calendar → Reservation list: renders (evidence: `src/agenda/index.tsx`)
- Expandable calendar → Month calendar: renders (evidence: `src/expandableCalendar/index.tsx`)
- Expandable calendar → Week calendar: renders (evidence: `src/expandableCalendar/index.tsx`)
- Week calendar → Calendar context: reads context (evidence: `src/expandableCalendar/WeekCalendar/index.tsx`)
- Agenda list → Calendar context: reads context (evidence: `src/expandableCalendar/AgendaList/agendaList.tsx`)
- Timeline list → Timeline view: renders pages (evidence: `src/timeline-list/index.tsx`)
- Timeline list → Infinite list: uses list (evidence: `src/timeline-list/index.tsx`)
- Timeline view → Locale services: uses locale (evidence: `src/timeline/Timeline.tsx`)
- Month calendar → Date operations: uses dates (evidence: `src/calendar/index.tsx`)
- Month calendar → Date conversion: converts dates (evidence: `src/calendar/index.tsx`)
- Agenda calendar → Date operations: compares dates (evidence: `src/agenda/index.tsx`)
- Agenda list → Date operations: uses dates (evidence: `src/expandableCalendar/AgendaList/agendaList.tsx`)
- Scrollable calendar → Prop update helpers: extracts props (evidence: `src/calendar-list/index.tsx`)
- Agenda calendar → Prop update helpers: updates props (evidence: `src/agenda/index.tsx`)
