Getting Started

What is Tarikh?

@coreify/tarikh is a modern Bangladesh-first date toolkit for JavaScript, TypeScript, and React.

It is built for Bangla dates, Bengali calendar conversion, culturally correct formatting, and localized output without extra dependencies.

Quick Install

npm install @coreify/tarikh

At a Glance

import { format, fromNow, toBanglaCalendar } from "@coreify/tarikh";

format("2026-04-14", {
  mode: "bangla",
  locale: "bn-BD",
  format: "spoken"
});
// -> "পহেলা বৈশাখ ১৪৩৩"

fromNow(new Date(), { numeric: "auto" });
// -> "today"

toBanglaCalendar("2026-03-31", { locale: "bn-BD" });
// -> { day: "১৭", month: "চৈত্র", monthIndex: 12, year: "১৪৩২" }

Why this exists

JavaScript's Intl.DateTimeFormat and common date libraries do not solve these problems:

• Bangla calendar conversion
• Bangla digits in dates
• Hybrid formatting with English and Bangla in the same string
• Relative time in Bangla and English
• Parsing Bangla calendar and Gregorian date strings
• SSR-safe React components for date output

Tarikh is zero-dependency, tree-shakeable, and designed to work well in Bangladesh-focused apps.