# irajkumarr/nepali_kit architecture

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

- Interactive diagram: https://gitdiagram.com/irajkumarr/nepali_kit
- Repository: https://github.com/irajkumarr/nepali_kit

## Overview

nepali_kit is a Dart/Flutter toolkit for Bikram Sambat calendar calculations, localization, and calendar UI. A typical workflow constructs a Nepali date, optionally converts it to Gregorian time, then formats it for display; Flutter apps can also present calendars and date pickers. The graph preserves the README’s other major capabilities. Source excerpts were unavailable, so relationships are limited to documented usage and feature descriptions; edges cite the README.

Main entry points: [`lib/src/calendar/nepali_date.dart`](https://github.com/irajkumarr/nepali_kit/blob/main/lib/src/calendar/nepali_date.dart) (BS Dates), [`lib/src/calendar/nepali_date_range.dart`](https://github.com/irajkumarr/nepali_kit/blob/main/lib/src/calendar/nepali_date_range.dart) (Date Ranges), [`lib/src/conversion/bs_ad_converter.dart`](https://github.com/irajkumarr/nepali_kit/blob/main/lib/src/conversion/bs_ad_converter.dart) (BS–AD Conversion), [`lib/src/conversion/date_extensions.dart`](https://github.com/irajkumarr/nepali_kit/blob/main/lib/src/conversion/date_extensions.dart) (Date Extensions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_calendar["Calendar Core"]
  node_dates["BS Dates<br/>[nepali_date.dart]"]
  node_date_time["BS Date-Time"]
  node_ranges["Date Ranges"]
  node_conversion["BS–AD Conversion"]
  node_date_extensions["Date Extensions"]
end

subgraph group_locale["Localization"]
  node_formatting["Date Formatting"]
  node_digits["Nepali Digits<br/>[nepali_digits.dart]"]
  node_number_format["Number &amp; Currency"]
  node_number_words["Number to Words"]
  node_transliteration["Transliteration"]
  node_relative_time["Relative Time<br/>[nepali_moment.dart]"]
end

subgraph group_domain["Date Services"]
  node_fiscal["Fiscal Years"]
  node_quarters["Fiscal Quarters"]
  node_holidays["Holiday Service"]
  node_holiday_data["Holiday Data<br/>[holiday_data.dart]"]
  node_events["Calendar Events"]
end

subgraph group_flutter["Flutter UI"]
  node_nepali_calendar_ui["Nepali Calendar"]
  node_ad_calendar_ui["AD Calendar"]
  node_pickers["Date Pickers"]
  node_range_picker["Range Picker"]
  node_month_picker["Month Picker"]
  node_year_picker["Year Picker"]
  node_dual_display["Dual-Date Display"]
  node_theme["Calendar Theme"]
end

node_developer(("Dart / Flutter App"))

node_developer -->|"constructs dates"| node_dates
node_dates -->|"converts to AD"| node_conversion
node_developer -->|"converts dates"| node_date_extensions
node_developer -->|"formats dates"| node_formatting
node_developer -->|"converts numbers"| node_number_words
node_developer -->|"formats numbers"| node_number_format
node_developer -->|"converts digits"| node_digits
node_developer -->|"formats relative time"| node_relative_time
node_developer -->|"calculates fiscal years"| node_fiscal
node_developer -->|"looks up holidays"| node_holidays
node_developer -->|"displays calendar"| node_nepali_calendar_ui
node_developer -->|"displays calendar"| node_ad_calendar_ui
node_developer -->|"selects dates"| node_pickers
node_developer -->|"selects ranges"| node_range_picker
node_developer -->|"selects months"| node_month_picker
node_developer -->|"selects years"| node_year_picker
node_developer -->|"displays dual dates"| node_dual_display
node_developer -->|"provides events"| node_events
node_developer -->|"uses text tools"| node_transliteration
node_developer -->|"creates date ranges"| node_ranges

click node_dates "https://github.com/irajkumarr/nepali_kit/blob/main/lib/src/calendar/nepali_date.dart"
click node_date_time "https://github.com/irajkumarr/nepali_kit/blob/main/lib/src/calendar/nepali_date_time.dart"
click node_ranges "https://github.com/irajkumarr/nepali_kit/blob/main/lib/src/calendar/nepali_date_range.dart"
click node_conversion "https://github.com/irajkumarr/nepali_kit/blob/main/lib/src/conversion/bs_ad_converter.dart"
click node_date_extensions "https://github.com/irajkumarr/nepali_kit/blob/main/lib/src/conversion/date_extensions.dart"
click node_formatting "https://github.com/irajkumarr/nepali_kit/blob/main/lib/src/formatting/nepali_date_format.dart"
click node_digits "https://github.com/irajkumarr/nepali_kit/blob/main/lib/src/numbers/nepali_digits.dart"
click node_number_format "https://github.com/irajkumarr/nepali_kit/blob/main/lib/src/numbers/nepali_number_format.dart"
click node_number_words "https://github.com/irajkumarr/nepali_kit/blob/main/lib/src/text/nepali_unicode.dart"
click node_transliteration "https://github.com/irajkumarr/nepali_kit/blob/main/lib/src/text/transliteration_engine.dart"
click node_relative_time "https://github.com/irajkumarr/nepali_kit/blob/main/lib/src/relative_time/nepali_moment.dart"
click node_fiscal "https://github.com/irajkumarr/nepali_kit/blob/main/lib/src/fiscal/nepali_fiscal_year.dart"
click node_quarters "https://github.com/irajkumarr/nepali_kit/blob/main/lib/src/fiscal/nepali_fiscal_quarter.dart"
click node_holidays "https://github.com/irajkumarr/nepali_kit/blob/main/lib/src/holidays/holiday_service.dart"
click node_holiday_data "https://github.com/irajkumarr/nepali_kit/blob/main/lib/src/holidays/holiday_data.dart"
click node_events "https://github.com/irajkumarr/nepali_kit/blob/main/lib/src/events/calendar_event.dart"
click node_nepali_calendar_ui "https://github.com/irajkumarr/nepali_kit/blob/main/lib/src/flutter/calendar/nepali_calendar_view.dart"
click node_ad_calendar_ui "https://github.com/irajkumarr/nepali_kit/blob/main/lib/src/flutter/calendar/ad_calendar_view.dart"
click node_pickers "https://github.com/irajkumarr/nepali_kit/blob/main/lib/src/flutter/pickers/nepali_date_picker_dialog.dart"
click node_range_picker "https://github.com/irajkumarr/nepali_kit/blob/main/lib/src/flutter/pickers/nepali_date_range_picker.dart"
click node_month_picker "https://github.com/irajkumarr/nepali_kit/blob/main/lib/src/flutter/pickers/nepali_month_picker.dart"
click node_year_picker "https://github.com/irajkumarr/nepali_kit/blob/main/lib/src/flutter/pickers/nepali_year_picker.dart"
click node_dual_display "https://github.com/irajkumarr/nepali_kit/blob/main/lib/src/flutter/dual_date/dual_date_display.dart"
click node_theme "https://github.com/irajkumarr/nepali_kit/blob/main/lib/src/flutter/theme/nepali_calendar_theme.dart"

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_dates,node_date_time,node_ranges,node_conversion,node_date_extensions toneBlue
class node_formatting,node_digits,node_number_format,node_number_words,node_transliteration,node_relative_time toneAmber
class node_fiscal,node_quarters,node_holidays,node_holiday_data,node_events toneMint
class node_nepali_calendar_ui,node_ad_calendar_ui,node_pickers,node_range_picker,node_month_picker,node_year_picker,node_dual_display,node_theme toneRose
class node_developer toneIndigo
```

## Components

### Calendar Core

- [BS Dates](https://github.com/irajkumarr/nepali_kit/blob/main/lib/src/calendar/nepali_date.dart): `lib/src/calendar/nepali_date.dart`
- [BS Date-Time](https://github.com/irajkumarr/nepali_kit/blob/main/lib/src/calendar/nepali_date_time.dart): `lib/src/calendar/nepali_date_time.dart`
- [Date Ranges](https://github.com/irajkumarr/nepali_kit/blob/main/lib/src/calendar/nepali_date_range.dart): `lib/src/calendar/nepali_date_range.dart`
- [BS–AD Conversion](https://github.com/irajkumarr/nepali_kit/blob/main/lib/src/conversion/bs_ad_converter.dart): `lib/src/conversion/bs_ad_converter.dart`
- [Date Extensions](https://github.com/irajkumarr/nepali_kit/blob/main/lib/src/conversion/date_extensions.dart): `lib/src/conversion/date_extensions.dart`

### Localization

- [Date Formatting](https://github.com/irajkumarr/nepali_kit/blob/main/lib/src/formatting/nepali_date_format.dart): `lib/src/formatting/nepali_date_format.dart`
- [Nepali Digits](https://github.com/irajkumarr/nepali_kit/blob/main/lib/src/numbers/nepali_digits.dart): `lib/src/numbers/nepali_digits.dart`
- [Number & Currency](https://github.com/irajkumarr/nepali_kit/blob/main/lib/src/numbers/nepali_number_format.dart): `lib/src/numbers/nepali_number_format.dart`
- [Number to Words](https://github.com/irajkumarr/nepali_kit/blob/main/lib/src/text/nepali_unicode.dart): `lib/src/text/nepali_unicode.dart`
- [Transliteration](https://github.com/irajkumarr/nepali_kit/blob/main/lib/src/text/transliteration_engine.dart): `lib/src/text/transliteration_engine.dart`
- [Relative Time](https://github.com/irajkumarr/nepali_kit/blob/main/lib/src/relative_time/nepali_moment.dart): `lib/src/relative_time/nepali_moment.dart`

### Date Services

- [Fiscal Years](https://github.com/irajkumarr/nepali_kit/blob/main/lib/src/fiscal/nepali_fiscal_year.dart): `lib/src/fiscal/nepali_fiscal_year.dart`
- [Fiscal Quarters](https://github.com/irajkumarr/nepali_kit/blob/main/lib/src/fiscal/nepali_fiscal_quarter.dart): `lib/src/fiscal/nepali_fiscal_quarter.dart`
- [Holiday Service](https://github.com/irajkumarr/nepali_kit/blob/main/lib/src/holidays/holiday_service.dart): `lib/src/holidays/holiday_service.dart`
- [Holiday Data](https://github.com/irajkumarr/nepali_kit/blob/main/lib/src/holidays/holiday_data.dart): `lib/src/holidays/holiday_data.dart`
- [Calendar Events](https://github.com/irajkumarr/nepali_kit/blob/main/lib/src/events/calendar_event.dart): `lib/src/events/calendar_event.dart`

### Flutter UI

- [Nepali Calendar](https://github.com/irajkumarr/nepali_kit/blob/main/lib/src/flutter/calendar/nepali_calendar_view.dart): `lib/src/flutter/calendar/nepali_calendar_view.dart`
- [AD Calendar](https://github.com/irajkumarr/nepali_kit/blob/main/lib/src/flutter/calendar/ad_calendar_view.dart): `lib/src/flutter/calendar/ad_calendar_view.dart`
- [Date Pickers](https://github.com/irajkumarr/nepali_kit/blob/main/lib/src/flutter/pickers/nepali_date_picker_dialog.dart): `lib/src/flutter/pickers/nepali_date_picker_dialog.dart`
- [Range Picker](https://github.com/irajkumarr/nepali_kit/blob/main/lib/src/flutter/pickers/nepali_date_range_picker.dart): `lib/src/flutter/pickers/nepali_date_range_picker.dart`
- [Month Picker](https://github.com/irajkumarr/nepali_kit/blob/main/lib/src/flutter/pickers/nepali_month_picker.dart): `lib/src/flutter/pickers/nepali_month_picker.dart`
- [Year Picker](https://github.com/irajkumarr/nepali_kit/blob/main/lib/src/flutter/pickers/nepali_year_picker.dart): `lib/src/flutter/pickers/nepali_year_picker.dart`
- [Dual-Date Display](https://github.com/irajkumarr/nepali_kit/blob/main/lib/src/flutter/dual_date/dual_date_display.dart): `lib/src/flutter/dual_date/dual_date_display.dart`
- [Calendar Theme](https://github.com/irajkumarr/nepali_kit/blob/main/lib/src/flutter/theme/nepali_calendar_theme.dart): `lib/src/flutter/theme/nepali_calendar_theme.dart`

### Other components

- **Dart / Flutter App**

## Connections

- Dart / Flutter App → BS Dates: constructs dates (evidence: `README.md`)
- BS Dates → BS–AD Conversion: converts to AD (evidence: `README.md`)
- Dart / Flutter App → Date Extensions: converts dates (evidence: `README.md`)
- Dart / Flutter App → Date Formatting: formats dates (evidence: `README.md`)
- Dart / Flutter App → Number to Words: converts numbers (evidence: `README.md`)
- Dart / Flutter App → Number & Currency: formats numbers (evidence: `README.md`)
- Dart / Flutter App → Nepali Digits: converts digits (evidence: `README.md`)
- Dart / Flutter App → Relative Time: formats relative time (evidence: `README.md`)
- Dart / Flutter App → Fiscal Years: calculates fiscal years (evidence: `README.md`)
- Dart / Flutter App → Holiday Service: looks up holidays (evidence: `README.md`)
- Dart / Flutter App → Nepali Calendar: displays calendar (evidence: `README.md`)
- Dart / Flutter App → AD Calendar: displays calendar (evidence: `README.md`)
- Dart / Flutter App → Date Pickers: selects dates (evidence: `README.md`)
- Dart / Flutter App → Range Picker: selects ranges (evidence: `README.md`)
- Dart / Flutter App → Month Picker: selects months (evidence: `README.md`)
- Dart / Flutter App → Year Picker: selects years (evidence: `README.md`)
- Dart / Flutter App → Dual-Date Display: displays dual dates (evidence: `README.md`)
- Dart / Flutter App → Calendar Events: provides events (evidence: `README.md`)
- Dart / Flutter App → Transliteration: uses text tools (evidence: `README.md`)
- Dart / Flutter App → Date Ranges: creates date ranges (evidence: `README.md`)
