PHPackages                             developersunesis/lang2js - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Localization & i18n](/categories/localization)
4. /
5. developersunesis/lang2js

ActiveLibrary[Localization & i18n](/categories/localization)

developersunesis/lang2js
========================

A package to copy Laravel lang files for JS use

05[1 issues](https://github.com/developersunesis/lang2js/issues)PHP

Since Aug 21Pushed 4y ago1 watchersCompare

[ Source](https://github.com/developersunesis/lang2js)[ Packagist](https://packagist.org/packages/developersunesis/lang2js)[ RSS](/packages/developersunesis-lang2js/feed)WikiDiscussions master Synced 1w ago

READMEChangelogDependenciesVersions (1)Used By (0)

Welcome to lang2js 👋
====================

[](#welcome-to-lang2js-)

 [![Version](https://camo.githubusercontent.com/d8766dfd7a274db82bddd2f49084453d96c3c89f125707b7c3d91e971b34d520/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f76657273696f6e2d302e302e312d626c75652e7376673f63616368655365636f6e64733d32353932303030)](https://camo.githubusercontent.com/d8766dfd7a274db82bddd2f49084453d96c3c89f125707b7c3d91e971b34d520/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f76657273696f6e2d302e302e312d626c75652e7376673f63616368655365636f6e64733d32353932303030) [ ![Documentation](https://camo.githubusercontent.com/5391604d1e8f886512ab4eeeb3922f4d58a8fac27454e641b1b39c65f51c4d6b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f646f63756d656e746174696f6e2d7965732d627269676874677265656e2e737667) ](https://github.com/developersunesis/lang2js#readme) [ ![License: MIT](https://camo.githubusercontent.com/fdf2982b9f5d7489dcf44570e714e3a15fce6253e0cc6b5aa61a075aac2ff71b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d79656c6c6f772e737667) ](#) [ ![Twitter: developrsunesis](https://camo.githubusercontent.com/31f7304de51f04b0a87c5592247a6f94e4a1fccd77441b4f5362da6fdfa283af/68747470733a2f2f696d672e736869656c64732e696f2f747769747465722f666f6c6c6f772f646576656c6f707273756e657369732e7376673f7374796c653d736f6369616c) ](https://twitter.com/developrsunesis)

> A package that provides an easy way to export and sync Laravel localization files for JavaScript use

Problem
-------

[](#problem)

I have a Laravel project/website, while thinking of how to sync my localization and translation files from the app for JavaScript usage; my first approach was to have the localization content stored in the `localStorage` of the browser when a user first visits the app. While this was a goto solution, I realized this wasn't efficient enough, because it meant that the first page the user visits might not have its strings translated until the localization is available already in the `localStorage`. Another solution, was to inject the localization content directly into a `DOMElement`: ``, clearly there was a trade-off as this drastically increased the page load time but solves the problem of the translations not being available.

#### Final Solution

[](#final-solution)

My final solution which is currently in use was to have a package periodically sync the localization files for JavaScript use. The package reads the following files:

```
resources
├── lang
│   ├── en
│   │   ├── auth.php
│   │   └── dashboard.php
│   ├── fr
│   │   ├── auth.php
│   │   └── dashboard.php

```

and converts it to minified js files

```
public
├── js
│   ├── locales
│   │   ├── en.min.js
│   │   ├── fr.min.js
│   │   └── lang2js.min.js

```

So each locale that needs to be used is imported into my blade component

```
...

       let helloText = __("index.TEST_2", 'en') // this function is provided by `lang2js.min.js`
       document.getElementById("hellotext").innerHTML = helloText

...
```

Install
-------

[](#install)

```
composer require developersunesis/lang2js
```

Usage
-----

[](#usage)

You can simply run a command

```
php artisan lang2js:export exportDir=:exportDir
```

The command above reads the translation files from Laravel default lang folder.

But if you have a custom location you want the translation files to be read from, you can use the following

```
php artisan lang2js:export exportDir=:exportPath localesDir=:localesPath
```

The two commands above uses the base path of the app and the path you specified as their absolute path.
Example:

```
php artisan lang2js:export exportDir=/public/js/locales localesDir=/resources/lang

# Uses full path
# exportDir == {YOUR_CURRENT_APP_LOCATION}/public/js/locales
# localesDir == {YOUR_CURRENT_APP_LOCATION}/public/resources/lang
```

To disable to command from using your base app file, you can add an option to the command as below

```
php artisan lang2js:export exportDir=C:/manners/Documents/public/js/locales localesDir=C:/manners/Documents/resources/lang --useBasePath=false
```

There are various use cases, one of which is to create a schedule for the package to resync the JavaScript translations periodically, this is very useful if you make use of laravel localizations that can be dynamically changed

```
$command = "php artisan lang2js:export exportDir=/public/js/locales"
$schedule->command($command)
          ->weekdays()
          ->daily();

# or through a facade function call
$schedule->call(function () {
    $lang2js = new Lang2js();
    $lang2js->setExportsDir("resources/exports");
    $lang2js->export();
})->weekly()->daily();

# or through a facade function call
$schedule->call(function () {
    L2J::setExportsDir("/public/js/locales")->export();
})->weekly()->daily();
```

Author
------

[](#author)

👤 **Uche Emmanuel**

- Website:
- Twitter: [@developrsunesis](https://twitter.com/developrsunesis)
- Github: [@developersunesis](https://github.com/developersunesis)
- LinkedIn: [@developersunesis](https://linkedin.com/in/developersunesis)

🤝 Contributing
--------------

[](#-contributing)

Contributions, issues and feature requests are welcome!
Feel free to check [issues page](https://github.com/developersunesis/lang2js/issues).

Show your support
-----------------

[](#show-your-support)

Give a ⭐️ if this project helped you!

---

*This README was generated with ❤️ by [readme-md-generator](https://github.com/kefranabg/readme-md-generator)*

###  Health Score

16

—

LowBetter than 5% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity4

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity28

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/f7e8a94a4a51f2cfcbe169044e20a8e99d12075a22ae5ae33d2ba2267ec316c5?d=identicon)[developersunesis](/maintainers/developersunesis)

---

Top Contributors

[![aerecurax](https://avatars.githubusercontent.com/u/20749859?v=4)](https://github.com/aerecurax "aerecurax (23 commits)")

### Embed Badge

![Health badge](/badges/developersunesis-lang2js/health.svg)

```
[![Health](https://phpackages.com/badges/developersunesis-lang2js/health.svg)](https://phpackages.com/packages/developersunesis-lang2js)
```

###  Alternatives

[joedixon/laravel-translation

A tool for managing all of your Laravel translations

717911.4k11](/packages/joedixon-laravel-translation)[illuminate/translation

The Illuminate Translation package.

6936.4M495](/packages/illuminate-translation)[lajax/yii2-translate-manager

Translation management extension for Yii 2

227578.8k13](/packages/lajax-yii2-translate-manager)[larswiegers/laravel-translations-checker

Make sure your laravel translations are checked and are included in all languages.

256423.2k2](/packages/larswiegers-laravel-translations-checker)[inpsyde/multilingual-press

Simply THE multisite-based free open source plugin for your multilingual websites.

2414.0k1](/packages/inpsyde-multilingual-press)[statikbe/laravel-chained-translator

The Laravel Chained Translator can combine several translators that can override each others translations.

36149.4k6](/packages/statikbe-laravel-chained-translator)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)