https://github.com/messageformat/messageformat
ICU MessageFormat and Unicode Messageformat for Javascript
https://github.com/messageformat/messageformat
language messageformat
Last synced: about 1 month ago
JSON representation
ICU MessageFormat and Unicode Messageformat for Javascript
- Host: GitHub
- URL: https://github.com/messageformat/messageformat
- Owner: messageformat
- License: mit
- Created: 2012-01-25T12:56:20.000Z (over 14 years ago)
- Default Branch: main
- Last Pushed: 2025-12-03T09:22:21.000Z (5 months ago)
- Last Synced: 2026-03-25T05:32:38.086Z (about 1 month ago)
- Topics: language, messageformat
- Language: TypeScript
- Homepage: https://messageformat.github.io
- Size: 7.26 MB
- Stars: 1,763
- Watchers: 30
- Forks: 159
- Open Issues: 19
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
- awesome-software-engineering-tools - messageformat
- awesome-i18n - messageformat - ICU MessageFormat for Javascript - i18n Plural and Gender Capable Messages (📦 Libraries / JavaScript / TypeScript)
README
messageformat
The experience and subtlety of your program's text can be important.
Messageformat is a mechanism for handling both **pluralization** and **gender** in your applications.
It can also lead to much better translations, as it's designed to support [all the languages] included in the [Unicode CLDR].
This monorepo provides packages supporting JS implementations of both [Unicode MessageFormat 2] (MF2) and [ICU MessageFormat] (MF1):
## Unicode MessageFormat 2
- [messageformat](mf2/messageformat/) - MF2 parser, runtime, and polyfill for Intl.MessageFormat
- [@messageformat/fluent](mf2/fluent) - Compile Fluent sources into MF2 resources
- [@messageformat/icu-messageformat-1](mf2/icu-messageformat-1) - Compile MF1 sources into MF2 formatters
- [@messageformat/xliff](mf2/xliff) - **_(ALPHA)_** Convert between XLIFF 2 and MF2
## ICU MessageFormat 1
- [@messageformat/cli](mf1/packages/cli/) - A command-line client for the library
- [@messageformat/convert](mf1/packages/convert/) - Converts other localization formats into ICU MessageFormat
- [@messageformat/core](mf1/packages/core/) - The core library that transpiles MessageFormat strings into JavaScript functions
- [@messageformat/date-skeleton](mf1/packages/date-skeleton) - Tools for working with [ICU DateFormat skeletons]
- [@messageformat/loader](mf1/packages/webpack-loader/) - Webpack loader for JSON, YAML, & .properties message files
- [@messageformat/number-skeleton](mf1/packages/number-skeleton) - Tools for working with [ICU NumberFormat skeletons]
- [@messageformat/parser](mf1/packages/parser/) - Parses MessageFormat source strings into an AST
- [@messageformat/react](mf1/packages/react/) - React hooks and other bindings for messages
- [@messageformat/runtime](mf1/packages/runtime/) - Runtime dependencies of compiled message modules
- [rollup-plugin-messageformat](mf1/packages/rollup-plugin/) - Rollup plugin for JSON, YAML, & .properties message files
[all the languages]: http://www.unicode.org/cldr/charts/latest/supplemental/language_plural_rules.html
[unicode cldr]: http://cldr.unicode.org/
[icu messageformat]: https://unicode-org.github.io/icu/userguide/format_parse/messages/
[unicode messageformat 2]: https://github.com/unicode-org/message-format-wg
[icu dateformat skeletons]: https://unicode-org.github.io/icu/userguide/format_parse/datetime/
[icu numberformat skeletons]: https://unicode-org.github.io/icu/userguide/format_parse/numbers/skeletons.html
### Getting Started (MF1)
Depending on your situation, consult one or more of the following guides:
- [Command-line](http://messageformat.github.io/messageformat/cli/)
- [Rollup](http://messageformat.github.io/messageformat/rollup/)
- [Webpack](http://messageformat.github.io/messageformat/webpack/)
- [React](http://messageformat.github.io/messageformat/react/)
Alternatively, take a look at our [examples](examples/) or dig into the [API documentation](http://messageformat.github.io/messageformat/api/) if you're looking to do something more involved.
Our [Format Guide] will help with the ICU MessageFormat Syntax, and the [Usage Guide] provides some further options for integrating messageformat to be a part of your workflow around UI texts and translations.
[format guide]: https://messageformat.github.io/messageformat/guide
[usage guide]: https://messageformat.github.io/messageformat/use
---
[Messageformat](https://messageformat.github.io/) is an OpenJS Foundation project, and we follow its [Code of Conduct](https://code-of-conduct.openjsf.org/).
