Repository files navigation

messageformat

The experience and subtlety of your program's text can be important.Messageformat is a mechanism for handling bothpluralization andgender in your applications.It can also lead to much better translations, as it's designed to supportall the languages included in theUnicode CLDR.

This monorepo provides packages supporting JS implementations of bothICU MessageFormat (MF1) andUnicode MessageFormat 2 (MF2):

• @messageformat/cli - A command-line client for the library
• @messageformat/convert - Converts other localization formats into ICU MessageFormat
• @messageformat/core - The core library that transpiles MessageFormat strings into JavaScript functions
• @messageformat/date-skeleton - Tools for working withICU DateFormat skeletons
• @messageformat/loader - Webpack loader for JSON, YAML, & .properties message files
• @messageformat/number-skeleton - Tools for working withICU NumberFormat skeletons
• @messageformat/parser - Parses MessageFormat source strings into an AST
• @messageformat/react - React hooks and other bindings for messages
• @messageformat/runtime - Runtime dependencies of compiled message modules
• rollup-plugin-messageformat - Rollup plugin for JSON, YAML, & .properties message files

• messageformat -(BETA) Intl.MessageFormat / MF2 parser, runtime and polyfill
• @messageformat/fluent -(BETA) Compile Fluent sources into MF2 resources
• @messageformat/icu-messageformat-1 -(BETA) Compile MF1 sources into MF2 formatters

Depending on your situation, consult one or more of the following guides:

• Command-line
• Rollup
• Webpack
• React

Alternatively, take a look at ourexamples or dig into theAPI documentation if you're looking to do something more involved.

OurFormat Guide will help with the ICU MessageFormat Syntax, and theUsage Guide provides some further options for integrating messageformat to be a part of your workflow around UI texts and translations.

Messageformat is an OpenJS Foundation project, and we follow itsCode of Conduct.