Ninja Programmers Mindmeld

    TypeScript icon, indicating that this package has built-in type declarations

    0.1.1 • Public • Published

    i18n, Reimagined!

    A blazing fast and super small i18n library for Javascript


    Installation · API · Guides & Tips · Examples


    Lisan (Turkish: lee · sun) is an i18n (internationalization) library.

    It provides all essential tooling to have multiple languages in your applications and format numbers, currencies, ordinals & dates based on locale.

    Lisan's biggest difference compared to traditional i18n libraries is taking advantage of ES6 Template Literals and using them to generate functions to interpolate strings.

    What is Lisan trying to solve?

    Most of the i18n libraries are based on some sort of template engine to interpolate strings and these template engines use regex or loops under the hood to find & replace the placeholders.

    However, using regex lookups or javascript loops decreases the performance significantly (especially on client-side) since find & replace is being done on runtime.

    How lisan solves it?

    Lisan adds an extra step to CI, but a giant performance gain to app kind!

    Lisan introduces a Dictionary concept where a dictionary entry can be either just a string or a javascript function that interpolates placeholders and returns a string. Since there is no need finding & replacing placeholder templates, we can avoid using regex or loops.

    It is that simple.

    Of course, maintaining javascript files to store translations could be challenging and not ideal. Especially when using third-party software like transifex or crowdin.

    That's why Lisan also provides a compiler and a command line tool to generate Dictionary objects from Translation JSON files. Dictionary objects are saved in javascript files.

    Enriched with plugins

    Also, you can use existing plugins or write your plugins to extend the capabilities of Lisan.


    You can install lisan from the sources below, as you see fit.

    from npm

    npm install lisan

    from CDN

    <script src="" type="text/javascript"></script>

    After adding the script tag above, all public variables will be accessible via window.lisanJS variables.


    <script type="text/javascript">
      (() => {
        const { lisan, t, c, Lisan } = window.lisanJS;


    Platform IE Edge Firefox Chrome Nodejs
    Version 8+ All All All 8+


    This package is MIT licensed.


    npm i lisan

    DownloadsWeekly Downloads






    Unpacked Size

    35 kB

    Total Files


    Last publish


    • yatki