Awesome Open Source
Awesome Open Source


Internationalization in Typescript with Unicode CLDR, batteries included.

build codecov npm version



Install the NPM package:

npm install --save @phensley/cldr

Using Yarn:

yarn add @phensley/cldr


This project follows semantic versioning:


  • Bug fixes
  • Backwards-compatible
  • Resource pack compatibility maintained (packs from 1.0.0 are guaranteed to work for all 1.0.* versions)


  • New features
  • Backwards-compatible
  • Internal schema breaking changes (applications must load resource packs from the same major.minor version)
  • CLDR data upgrades which maintain backwards-compatibility


  • Public API breaking changes
  • CLDR data upgrades which change break API compatibility (unit deprecation / renaming, etc)


Package Naming

Packages with the cldr-* prefix represent pieces of the larger library and are designed to work together. The @phensley/cldr package pulls in the full functionality of the library.

Packages without the cldr-* prefix can be used in an application individually without pulling in the larger core library.

You can use any of the packages independent of the rest of the library:

package size dependencies
@phensley/cldr-utils min+gzip
@phensley/decimal min+gzip
@phensley/language-tag min+gzip
@phensley/locale min+gzip size includes language-tag package
@phensley/locale-matcher min+gzip size includes locale and language-tag packages
@phensley/messageformat min+gzip size includes cldr-utils, decimal, and plurals packages
@phensley/plurals min+gzip size includes decimal package
@phensley/timezone min+gzip size includes cldr-utils package
@phensley/unit-converter min+gzip size includes cldr-utils and decimal packages


  • Support a broad set of CLDR features in the browser "out of the box".
  • Support all scripts and regions for a language in a single compact resource pack.
  • Resolve the CLDR data size and dimensionality problems.
    • In the case of English: ~40MB of JSON for 105 locales is compressed to a 194KB resource pack (44KB gzip), a factor of approx. 200:1 uncompressed, 1000:1 with gzip compression.
  • No additional library dependencies required.
  • No custom extraction of CLDR data or precompilation of formatters required.
  • Correctness and consistency across browsers, Node.js, and other Javascript ES5 runtime environments.
  • Provide type-safety, reducing programming errors.
  • No familiarity with CLDR structure is required for developers to use this library.
  • High performance.
  • Arbitrary precision decimal math, to achieve the same accuracy in the browser as on the server.


Copyright 2018-present Patrick Hensley

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
See the License for the specific language governing permissions and
limitations under the License.


This project is not affiliated with the Unicode Inc. or the Unicode CLDR project.

Related Awesome Lists
Top Programming Languages
Top Projects

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Typescript (239,577
Language (30,084
Date (14,164
Math (9,750
Formatting (6,571
Localization (5,302
I18n (4,822
Unicode (4,454
Internationalization (3,312
Timezone (2,361
Pluralization (253
Cldr (247
Locale (193
Arbitrary Precision (179
Decimal (130
Messageformat (19
Globalize (3