Packages

Every NepaliKit package is independently installable, fully typed, and designed to work seamlessly together.

@nepali-utils/core

Core Bikram Sambat utilities for TypeScript

A framework-agnostic TypeScript library providing everything you need to work with the Bikram Sambat calendar system — date conversion, formatting, location data, phone validation, currency utilities, and more.

BS ↔ AD date conversion with high accuracy
Nepali number & currency formatting
Complete Nepal location data (7 provinces, 77 districts, municipalities, wards)
Nepali mobile number validation
Calendar grid generation for UI rendering
Zero runtime dependencies

bash

1npm install @nepali-utils/core

Details Docs

date-picker-bs

Bikram Sambat date picker for React

A React component library that provides a beautiful, accessible date picker and standalone calendar for the Bikram Sambat (Nepali) calendar system. Built on Radix UI, Tailwind CSS, and @nepali-utils/core.

DatePickerBS — popover-based date picker with trigger button
CalendarBS — standalone inline calendar component
Full English and Nepali (Devanagari) language support
Configurable date constraints (min/max, disabled days)
Custom format patterns (e.g., YYYY MMMM DD)
Deep styling via classNames prop & CSS variables

bash

1npm install date-picker-bs

Details Docs