elm-fluent

elm-fluent is an internationalization/localization solution for Elm.

It features:

• A full implementation of Fluent - Mozilla's brilliant next generation translation/internationalization/localization system.
• A compiler approach that means you get excellent performance.
• Proper support for the classic 'plurals' problem in i18n, along with other i18n issues.
• Compile-time checking of every possible syntax or type error in your Fluent FTL files, by leveraging both Elm's type system and our own checks.
• Built-in ability to format numbers and dates according to locale, with ability to customize. This means strongly-typed messages and substitutions that help you avoid i18n issues you might not even know exist.
• An elegant solution for the thorny problem of internationalizing messages that contain HTML fragments (such as bold text and hyperlinks), while also allowing such elements to work as normal in Elm's event model (e.g. clickable links that send Elm messages).
• Excellent, explicit compile-time error messages - inspired by the Elm compiler.

It combines the power of Fluent with Elm's you-just-cant-break-it safety to give a very capable i18n solution.

Oveview

elm-fluent operates as a command line tool that compiles .ftl files to .elm files. The result is that each message becomes a function that will generate a translated string (or HTML fragment) for a given locale and an optional set of strongly typed parameters (string, dates or numbers).

Dates and numbers can also be passed with formatting parameters supplied - for example, to attach a currency to a number, so that it can be correctly formatted as a currency according to the rules of the locale in use.

Please see the docs for more information.

For discussion regarding Fluent, including elm-fluent, see also the Mozilla Discourse Fluent category.

Status

• Stable - used in production.

• A few rough edges - please see the list of open issues.

• A pretty complete test suite, and a nice set of docs.

• Compatibility: Elm 0.18 only.

  Elm 0.19 is problematic - we require a wrapper for Intl, but Elm doesn't have one yet and the restriction on native modules blocks us from writing our own.

  It is unclear if/when an official wrapper will be provided, or whether it will be suitable for elm-fluent. We use elm-intl which has proved ideal for our usage, but the core team apparently quickly dismissed adoption of a library like that.

  In light of this, and other problems caused by the restriction on native modules in 0.19, the author of elm-fluent may well be forced to move away from Elm. In this event the most likely outcome is a migration to bucklescript with bucklescript-tea and elm-fluent will be forked to target that platform instead. This repo will not be deleted but further development will likely stop.

• Free software: MIT license

Credits

This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.