Bikram Sambat dates
for React apps
A lightweight, accessible React component for selecting true Bikram Sambat (BS) dates. Pluggable conversion engine, dual-language support, and full keyboard navigation.
Try it live
Pick a Nepali date, switch languages, and test disable rules in real time.
โ ๏ธ Demo could not load. Make sure JavaScript is enabled.
Everything you need
A complete BS date picker experience with zero configuration required
True BS dates
Real Bikram Sambat arithmetic, not Gregorian approximations. Uses an authoritative day-by-day conversion table.
Pluggable adapter
Swap in custom conversion tables via the BsAdapter interface. Built-in MemoryBsAdapter for full control.
Dual language
Toggle between English and Nepali (เคจเฅเคชเคพเคฒเฅ) โ labels, month names, weekday abbreviations, and digit display.
Disable rules
Disable specific dates, ranges, today, or before/after boundaries. Combine minDate/maxDate with disable options.
Keyboard accessible
Escape to close, Tab to navigate, ARIA attributes, input masking, and automatic Nepali digit normalization.
Themable
Override every visual aspect via CSS variables. Font, sizing, colors โ match your application's design system.
Getting started
Install, import, and use in minutes
Install
Add the package to your React project:
$ npm install bos-nepali-date
Import the component
Import NepaliDatePicker and the defaultAdapter:
import { useState } from "react" import { NepaliDatePicker, defaultAdapter } from "bos-nepali-date"
Render & control
Wire up value and onChange, pass the adapter:
<NepaliDatePicker value={value} onChange={setValue} adapter={defaultAdapter} />