# surya9122prakash/schedultron architecture

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

- Interactive diagram: https://gitdiagram.com/surya9122prakash/schedultron
- Repository: https://github.com/surya9122prakash/schedultron

## Overview

Schedultron is a React calendar and scheduling component library. Consumers configure calendar views or booking pickers, interact with dated events, and receive selection and event-change callbacks; the library does not provide a persistence service. The graph covers the documented calendar, picker, recurrence, conflict, plugin, theme, and form capabilities. Several links rely on SOURCE INDEX references or README descriptions because their implementation excerpts are partial or unavailable.

Main entry points: [`src/components/DayView.tsx`](https://github.com/surya9122prakash/schedultron/blob/master/src/components/DayView.tsx) (Day view), [`src/components/CalendarPanel.tsx`](https://github.com/surya9122prakash/schedultron/blob/master/src/components/CalendarPanel.tsx) (Calendar panel), [`src/components/EventFormModal.tsx`](https://github.com/surya9122prakash/schedultron/blob/master/src/components/EventFormModal.tsx) (Event form), [`src/components/pluginSystem.ts`](https://github.com/surya9122prakash/schedultron/blob/master/src/components/pluginSystem.ts) (Plugin hooks)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_calendar["Calendar views"]
  node_calendar["Calendar coordinator<br/>[Calendar.tsx]"]
  node_day["Day view<br/>[DayView.tsx]"]
  node_week["Week view<br/>[WeekView.tsx]"]
  node_month["Month view<br/>[MonthView.tsx]"]
end

subgraph group_booking["Booking pickers"]
  node_panel["Calendar panel<br/>[CalendarPanel.tsx]"]
  node_date_picker["Date picker<br/>[DatePicker.tsx]"]
  node_date_range["Date range picker"]
  node_datetime_picker["Date-time picker<br/>[DateTimePicker.tsx]"]
  node_datetime_range["Date-time range picker"]
  node_slot_picker["Slot date picker<br/>[SlotDatePicker.tsx]"]
  node_time_picker["Time pickers<br/>[TimePicker.tsx]"]
end

subgraph group_event_ops["Event operations"]
  node_event_form["Event form<br/>[EventFormModal.tsx]"]
  node_drag_resize["Drag and resize"]
  node_recurrence["Recurrence handling<br/>[utils.ts]"]
  node_conflicts["Conflict detection<br/>[utils.ts]"]
  node_plugins["Plugin hooks<br/>[pluginSystem.ts]"]
end

subgraph group_shared["Shared behavior"]
  node_time_utils["Time and slot utilities<br/>[utils.ts]"]
  node_themes["Calendar themes<br/>[calendarThemes.ts]"]
  node_types["Shared types<br/>[types.ts]"]
end

node_consumer(("Library consumer"))

node_consumer -->|"configures view"| node_day
node_consumer -.->|"uses calendar"| node_calendar
node_consumer -.->|"selects dates"| node_date_picker
node_calendar -->|"renders view"| node_day
node_day -->|"opens form"| node_event_form
node_day -->|"dispatches hooks"| node_plugins
node_day -.->|"handles gestures"| node_drag_resize
node_week -->|"dispatches hooks"| node_plugins
node_week -.->|"handles gestures"| node_drag_resize
node_month -->|"opens form"| node_event_form
node_month -->|"dispatches hooks"| node_plugins
node_event_form -->|"renders field"| node_datetime_range
node_event_form -->|"renders field"| node_date_picker
node_date_picker -->|"renders panel"| node_panel
node_date_range -->|"renders panel"| node_panel
node_datetime_picker -->|"renders panel"| node_panel
node_datetime_range -->|"renders panel"| node_panel
node_datetime_picker -->|"applies theme"| node_themes
node_datetime_range -->|"applies theme"| node_themes
node_panel -->|"applies theme"| node_themes
node_day -->|"generates slots"| node_time_utils
node_week -->|"generates slots"| node_time_utils
node_drag_resize -->|"uses slot height"| node_time_utils
node_time_utils -->|"expands recurrence"| node_recurrence
node_day -->|"uses event types"| node_types
node_plugins -->|"uses plugin contracts"| node_types

click node_calendar "https://github.com/surya9122prakash/schedultron/blob/master/src/components/Calendar.tsx"
click node_day "https://github.com/surya9122prakash/schedultron/blob/master/src/components/DayView.tsx"
click node_week "https://github.com/surya9122prakash/schedultron/blob/master/src/components/WeekView.tsx"
click node_month "https://github.com/surya9122prakash/schedultron/blob/master/src/components/MonthView.tsx"
click node_panel "https://github.com/surya9122prakash/schedultron/blob/master/src/components/CalendarPanel.tsx"
click node_date_picker "https://github.com/surya9122prakash/schedultron/blob/master/src/components/DatePicker.tsx"
click node_date_range "https://github.com/surya9122prakash/schedultron/blob/master/src/components/DateRangePicker.tsx"
click node_datetime_picker "https://github.com/surya9122prakash/schedultron/blob/master/src/components/DateTimePicker.tsx"
click node_datetime_range "https://github.com/surya9122prakash/schedultron/blob/master/src/components/DateTimeRangePicker.tsx"
click node_slot_picker "https://github.com/surya9122prakash/schedultron/blob/master/src/components/SlotDatePicker.tsx"
click node_time_picker "https://github.com/surya9122prakash/schedultron/blob/master/src/components/TimePicker.tsx"
click node_event_form "https://github.com/surya9122prakash/schedultron/blob/master/src/components/EventFormModal.tsx"
click node_drag_resize "https://github.com/surya9122prakash/schedultron/blob/master/src/hooks/useDragAndResize.ts"
click node_recurrence "https://github.com/surya9122prakash/schedultron/blob/master/src/components/utils.ts"
click node_conflicts "https://github.com/surya9122prakash/schedultron/blob/master/src/components/utils.ts"
click node_plugins "https://github.com/surya9122prakash/schedultron/blob/master/src/components/pluginSystem.ts"
click node_time_utils "https://github.com/surya9122prakash/schedultron/blob/master/src/components/utils.ts"
click node_themes "https://github.com/surya9122prakash/schedultron/blob/master/src/components/calendarThemes.ts"
click node_types "https://github.com/surya9122prakash/schedultron/blob/master/src/components/types.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_calendar,node_day,node_week,node_month toneBlue
class node_panel,node_date_picker,node_date_range,node_datetime_picker,node_datetime_range,node_slot_picker,node_time_picker toneAmber
class node_event_form,node_drag_resize,node_recurrence,node_conflicts,node_plugins toneMint
class node_time_utils,node_themes,node_types toneRose
class node_consumer toneIndigo
```

## Components

### Calendar views

- [Calendar coordinator](https://github.com/surya9122prakash/schedultron/blob/master/src/components/Calendar.tsx): `src/components/Calendar.tsx`
- [Day view](https://github.com/surya9122prakash/schedultron/blob/master/src/components/DayView.tsx): `src/components/DayView.tsx`
- [Week view](https://github.com/surya9122prakash/schedultron/blob/master/src/components/WeekView.tsx): `src/components/WeekView.tsx`
- [Month view](https://github.com/surya9122prakash/schedultron/blob/master/src/components/MonthView.tsx): `src/components/MonthView.tsx`

### Booking pickers

- [Calendar panel](https://github.com/surya9122prakash/schedultron/blob/master/src/components/CalendarPanel.tsx): `src/components/CalendarPanel.tsx`
- [Date picker](https://github.com/surya9122prakash/schedultron/blob/master/src/components/DatePicker.tsx): `src/components/DatePicker.tsx`
- [Date range picker](https://github.com/surya9122prakash/schedultron/blob/master/src/components/DateRangePicker.tsx): `src/components/DateRangePicker.tsx`
- [Date-time picker](https://github.com/surya9122prakash/schedultron/blob/master/src/components/DateTimePicker.tsx): `src/components/DateTimePicker.tsx`
- [Date-time range picker](https://github.com/surya9122prakash/schedultron/blob/master/src/components/DateTimeRangePicker.tsx): `src/components/DateTimeRangePicker.tsx`
- [Slot date picker](https://github.com/surya9122prakash/schedultron/blob/master/src/components/SlotDatePicker.tsx): `src/components/SlotDatePicker.tsx`
- [Time pickers](https://github.com/surya9122prakash/schedultron/blob/master/src/components/TimePicker.tsx): `src/components/TimePicker.tsx`

### Event operations

- [Event form](https://github.com/surya9122prakash/schedultron/blob/master/src/components/EventFormModal.tsx): `src/components/EventFormModal.tsx`
- [Drag and resize](https://github.com/surya9122prakash/schedultron/blob/master/src/hooks/useDragAndResize.ts): `src/hooks/useDragAndResize.ts`
- [Recurrence handling](https://github.com/surya9122prakash/schedultron/blob/master/src/components/utils.ts): `src/components/utils.ts`
- [Conflict detection](https://github.com/surya9122prakash/schedultron/blob/master/src/components/utils.ts): `src/components/utils.ts`
- [Plugin hooks](https://github.com/surya9122prakash/schedultron/blob/master/src/components/pluginSystem.ts): `src/components/pluginSystem.ts`

### Shared behavior

- [Time and slot utilities](https://github.com/surya9122prakash/schedultron/blob/master/src/components/utils.ts): `src/components/utils.ts`
- [Calendar themes](https://github.com/surya9122prakash/schedultron/blob/master/src/components/calendarThemes.ts): `src/components/calendarThemes.ts`
- [Shared types](https://github.com/surya9122prakash/schedultron/blob/master/src/components/types.ts): `src/components/types.ts`

### Other components

- **Library consumer**

## Connections

- Library consumer → Day view: configures view (evidence: `README.md`)
- Library consumer → Calendar coordinator: uses calendar
- Library consumer → Date picker: selects dates
- Calendar coordinator → Day view: renders view (evidence: `src/components/Calendar.tsx`)
- Day view → Event form: opens form (evidence: `src/components/DayView.tsx`)
- Day view → Plugin hooks: dispatches hooks (evidence: `src/components/DayView.tsx`)
- Day view → Drag and resize: handles gestures (evidence: `src/components/DayView.tsx`)
- Week view → Plugin hooks: dispatches hooks (evidence: `src/components/WeekView.tsx`)
- Week view → Drag and resize: handles gestures (evidence: `src/components/WeekView.tsx`)
- Month view → Event form: opens form (evidence: `src/components/MonthView.tsx`)
- Month view → Plugin hooks: dispatches hooks (evidence: `src/components/MonthView.tsx`)
- Event form → Date-time range picker: renders field (evidence: `src/components/EventFormModal.tsx`)
- Event form → Date picker: renders field (evidence: `src/components/EventFormModal.tsx`)
- Date picker → Calendar panel: renders panel (evidence: `src/components/DatePicker.tsx`)
- Date range picker → Calendar panel: renders panel (evidence: `src/components/DateRangePicker.tsx`)
- Date-time picker → Calendar panel: renders panel (evidence: `src/components/DateTimePicker.tsx`)
- Date-time range picker → Calendar panel: renders panel (evidence: `src/components/DateTimeRangePicker.tsx`)
- Date-time picker → Calendar themes: applies theme (evidence: `src/components/DateTimePicker.tsx`)
- Date-time range picker → Calendar themes: applies theme (evidence: `src/components/DateTimeRangePicker.tsx`)
- Calendar panel → Calendar themes: applies theme (evidence: `src/components/CalendarPanel.tsx`)
- Day view → Time and slot utilities: generates slots (evidence: `src/components/DayView.tsx`)
- Week view → Time and slot utilities: generates slots (evidence: `src/components/WeekView.tsx`)
- Drag and resize → Time and slot utilities: uses slot height (evidence: `src/hooks/useDragAndResize.ts`)
- Time and slot utilities → Recurrence handling: expands recurrence (evidence: `src/components/utils.ts`)
- Day view → Shared types: uses event types (evidence: `src/components/DayView.tsx`)
- Plugin hooks → Shared types: uses plugin contracts (evidence: `src/components/pluginSystem.ts`)
