v1.0.0 Universal Release10+ Platforms Supported🏢 By Inline Tech Solution ↗

Mero Miti Developer Documentation

Universal Bikram Sambat (B.S.) calendar engine, datepicker, fiscal year calculator, and bidirectional AD ↔ BS converter across 10+ platforms. High-speed, offline-first, and ultra-compact (< 1 KB).

npm@meromiti/*Packagistmeromiti/meromitipub.devmero_mitiPyPImero-mitiNuGetMeroMitiGitHubv1.0.0 ↗
📆 Try the live interactive UI datepicker widget→

Universal Bikram Sambat Calendar SDKs for All Major Frameworks

Mero Miti provides standardized, ultra-lightweight (< 1 KB) Bikram Sambat packages across frontend and backend environments with native fiscal year calculation and dynamic sync:

⚛️ React & Next.js

React Nepali date picker components with bidirectional synchronization.

npm i @meromiti/react

💚 Vue 3 & Nuxt

Vue 3 composition-ready Bikram Sambat datepicker with v-model.

npm i @meromiti/vue

🅰️ Angular

Standalone Angular components & reactive forms directive.

npm i @meromiti/angular

💙 Flutter & Dart

Native Material & Cupertino Nepali datepicker dialog & text field.

flutter pub add mero_miti

🐘 PHP & Laravel

Laravel ServiceProvider, bs_date validation rule & Fiscal Year engine.

composer require meromiti/meromiti

🐍 Python & Django

Django model fields, FastAPI Pydantic validators, AD/BS conversion.

pip install mero-miti

🟣 .NET & C#

High-performance .NET 8.0 & .NET Standard 2.0 ASP.NET binders.

dotnet add package MeroMiti

🌐 Web / Plain JS

Zero-config drop-in script for HTML forms, WordPress, & PHP.

npm i @meromiti/web
Select Your Platform or Language:
⚛️

React

v1.0.0Frontend / UI

Drop-in React components with bidirectional Gregorian synchronization, keyboard navigation, and theme customization.

View on npm↗
Installation:
npm install @meromiti/react
Key Highlights:
✓<MeroMitiPicker> full standalone calendar dropdown
✓<MeroMitiCompanion> attach to existing form input
✓Full TypeScript typings & zero external dependencies
✓Light & Dark mode auto-detection
Code Example:
import React, { useState } from 'react';
import { MeroMitiPicker, MeroMitiCompanion } from '@meromiti/react';

export default function MyForm() {
  const [bsDate, setBsDate] = useState('2081-05-19');

  return (
    <div className="p-4 space-y-4">
      {/* 1. Full Standalone Picker */}
      <MeroMitiPicker
        value={bsDate}
        onChange={(bs, ad) => {
          console.log('BS:', bs, 'AD:', ad);
          setBsDate(bs);
        }}
        locale="ne"
        format="DD/MM/YYYY"
      />

      {/* 2. Synced Companion next to native AD input */}
      <MeroMitiCompanion
        adInputId="event_date"
        locale="ne"
        position="right"
      />
    </div>
  );
}

Universal Engine Capabilities

Every single SDK shares the identical verified calendar math. Whether you run PHP, React, Python, Flutter, or .NET, date calculations are 100% deterministic and synchronized.

📊

Fiscal Year & Quarters Engine

Native Nepal Government fiscal year support (Shrawan 1 – Ashadh end). Computes fiscal codes (e.g. 2081/82, २०८१/८२) and exact financial quarters (Q1–Q4) with Gregorian boundaries.

getFiscalYear(date) → "2081/82"
getFiscalQuarter(date) → Q1 (श्रावण-आश्विन)
⚡

< 1 KB 24-Bit Encoded Engine

100+ years of calendar variations (29 to 32 days per month) packed into a compact 24-bit encoded table under 1 KB. Zero network calls and microsecond execution.

1970 BS – 2100 BS • < 1,024 bytes
Zero latency • 100% offline reliability
🔄

Future-Proof Dynamic Sync

When the Nepal Calendar Determination Committee announces future years, new year tables can be dynamically registered at runtime or synced from Mero Miti Cloud API without rebuilding apps.

registerYear(2083, daysArray)
MeroMiti.syncFutureYears()

Complete Ecosystem Package Registry Matrix

↔ Swipe horizontally
PlatformPackage IDRegistryVersionQuick Install
⚛️React@meromiti/react ↗npmv1.0.0npm install @meromiti/react
💚Vue 3@meromiti/vue ↗npmv1.0.0npm install @meromiti/vue
🅰️Angular@meromiti/angular ↗npmv1.0.0npm install @meromiti/angular
🌐Web / Vanilla JS@meromiti/web ↗npmv1.0.0<script src="https://meromiti.com/mero-miti.js" data-mero-miti-auto="true"></script>
📱React Native@meromiti/react-native ↗npmv1.0.0npm install @meromiti/react-native
💙Fluttermero_miti ↗pub.devv1.0.0flutter pub add mero_miti
🟨TypeScript / Node.js@meromiti/core ↗npmv1.0.0npm install @meromiti/core
🐘PHP & Laravelmeromiti/meromiti ↗Packagistv1.0.0composer require meromiti/meromiti
🐍Python & Djangomero-miti ↗PyPIv1.0.0pip install mero-miti
🟣.NET / C#MeroMiti ↗NuGetv1.0.0dotnet add package MeroMiti
🍎iOS & macOS (Swift)MeroMiti ↗Swift Package Managerv1.0.0https://github.com/inlinetechsolution/mero-miti.git

Open Source & Enterprise Support

All Mero Miti packages are 100% open-source under the MIT license. Maintained by Inline Tech Solution. Need custom integrations or enterprise support?

GitHub Repository ↗[email protected]