PHPackages                             menarasolutions/fluent-laravel - 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 &amp; i18n](/categories/localization)
4. /
5. menarasolutions/fluent-laravel

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

menarasolutions/fluent-laravel
==============================

Laravel package for Fluent translations (application localisation)

0.1.2(8y ago)127MITPHPPHP &gt;=5.5.0

Since May 9Pushed 8y ago1 watchersCompare

[ Source](https://github.com/MenaraSolutions/fluent-laravel)[ Packagist](https://packagist.org/packages/menarasolutions/fluent-laravel)[ Docs](https://github.com/MenaraSolutions/fluent-laravel)[ RSS](/packages/menarasolutions-fluent-laravel/feed)WikiDiscussions master Synced today

READMEChangelog (3)Dependencies (4)Versions (4)Used By (0)

fluent-laravel
==============

[](#fluent-laravel)

[![Build Status](https://camo.githubusercontent.com/da8643c6c4911be42dc5016cbbe9e1ddbdf0c7ae2a3d01fbe74609021ff6f4fd/68747470733a2f2f7472617669732d63692e6f72672f4d656e617261536f6c7574696f6e732f666c75656e742d6c61726176656c2e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/MenaraSolutions/fluent-laravel)[![Latest Stable Version](https://camo.githubusercontent.com/98e441e626429a5b2d7ded4a7c59c0d030956aaf2c0232b563471b5842e9f1fc/68747470733a2f2f706f7365722e707567782e6f72672f6d656e617261736f6c7574696f6e732f666c75656e742d6c61726176656c2f762f737461626c65)](https://packagist.org/packages/menarasolutions/fluent-laravel)[![Total Downloads](https://camo.githubusercontent.com/fb4a0d1e74dcb43c55902f8085ff887988d43884dc8f0e1446b6f15cefb3809b/68747470733a2f2f706f7365722e707567782e6f72672f6d656e617261736f6c7574696f6e732f666c75656e742d6c61726176656c2f646f776e6c6f616473)](https://packagist.org/packages/menarasolutions/fluent-laravel)[![Code Climate](https://camo.githubusercontent.com/608447175db225ea45912707f441799c454cfbea642bcf401b98218803269c7f/68747470733a2f2f636f6465636c696d6174652e636f6d2f6769746875622f4d656e617261536f6c7574696f6e732f666c75656e742d6c61726176656c2f6261646765732f6770612e737667)](https://codeclimate.com/github/MenaraSolutions/fluent-laravel)[![Test Coverage](https://camo.githubusercontent.com/2d077a0c7d2af0780901f198fc56d82d44dd59befd5b245f8e90e51a4ab6dfca/68747470733a2f2f636f6465636c696d6174652e636f6d2f6769746875622f4d656e617261536f6c7574696f6e732f666c75656e742d6c61726176656c2f6261646765732f636f7665726167652e737667)](https://codeclimate.com/github/MenaraSolutions/fluent-laravel/coverage)[![License](https://camo.githubusercontent.com/ec958a5974b5f36c3c059b8912d6c9a8637fc48916a5c22f40dc924c37e7474a/68747470733a2f2f706f7365722e707567782e6f72672f6d656e617261736f6c7574696f6e732f666c75656e742d6c61726176656c2f6c6963656e7365)](https://packagist.org/packages/menarasolutions/fluent-laravel)

Laravel package for Fluent translations (application localisation)

Localization flow of Laravel
----------------------------

[](#localization-flow-of-laravel)

Laravel offers two options for localization: key-based texts and plain JSON texts.

### Key-based language files: {locale}/{group}.php (PHP array format)

[](#key-based-language-files-localegroupphp-php-array-format)

Use: `__('auth.please_wait')`

Drawbacks: after adding a new key to the main locale, the same key has to be manually added to all other locales.

It's easy for locales to go out of sync. Some texts may be present in the language files but not be in use anywhere.

### JSON files: {locale}.json (JSON format)

[](#json-files-localejson-json-format)

Use: `__('Please wait, authorizing')`

Drawbacks: if the same text needs different translations in different contexts, this doesn't work well.

It's hard to say how much of content is translated because there is no original text dictionary.

Localization flow of Fluent
---------------------------

[](#localization-flow-of-fluent)

Fluent offers you to store and manage your translations in the "cloud" which makes it trivial to outsource translations to translation market places or colleagues. Even if you translate everything yourself, Fluent interface will be far more convenient for this task (eg. you will see clearly current status, get hints from MTs, find unused texts, etc).

Installation
------------

[](#installation)

Use Composer to install this package:

```
$ composer require menarasolutions/fluent-laravel
```

Add our service provider to `config/app.php`:

```
 'providers' => [
 /// ...
     MenaraSolutions\FluentLaravel\Providers\LaravelServiceProvider::class,
 /// ...
 ],
```

Create a config file (`config/fluent.php`):

```
$ php artisan vendor:publish
```

Add your Fluent API key and application ID in this config file and you are ready to run!

Uploading original texts
------------------------

[](#uploading-original-texts)

You need to submit your original, untranslated texts to Fluent from time to time so that you or your translators can start working on translations. To do that run `scan` command:

```
$ php artisan fluent:scan -v
```

This command will scan your `src` and `resources/views` folders and look for all invocations of `__()`, `trans()` and `@lang()`. Moreover, you will be prompted whether you want to upload your existing translations from `resources/lang` folder to Fluent.

Updating language files
-----------------------

[](#updating-language-files)

Run the following command anytime during development or during your CI/CD pipeline:

```
$ php artisan fluent:fetch
```

This command will look for any new translations on Fluent and download them to `resources/lang-fluent` folder.

Note
----

[](#note)

This package **will not** alter any of your files. This package creates an extra folder in `resources/` - `lang-fluent`, all new languagae files will be stored here.

You can move back to standard translation implementation at any time. Simply comment out our service provider in `config/app.php`.

###  Health Score

24

—

LowBetter than 32% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity9

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity50

Maturing project, gaining track record

 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.

###  Release Activity

Cadence

Every ~4 days

Total

3

Last Release

3282d ago

### Community

Maintainers

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

---

Top Contributors

[![dusterio](https://avatars.githubusercontent.com/u/11039918?v=4)](https://github.com/dusterio "dusterio (25 commits)")

---

Tags

phplaravellocalizationtranslation

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/menarasolutions-fluent-laravel/health.svg)

```
[![Health](https://phpackages.com/badges/menarasolutions-fluent-laravel/health.svg)](https://phpackages.com/packages/menarasolutions-fluent-laravel)
```

###  Alternatives

[mcamara/laravel-localization

Easy localization for Laravel

3.5k9.1M112](/packages/mcamara-laravel-localization)[codezero/laravel-localized-routes

A convenient way to set up, manage and use localized routes in a Laravel app.

543638.1k4](/packages/codezero-laravel-localized-routes)[jayesh/laravel-gemini-translator

An interactive command to extract and generate Laravel translations using Gemini AI.

691.7k1](/packages/jayesh-laravel-gemini-translator)[opgginc/codezero-laravel-localized-routes

A convenient way to set up, manage and use localized routes in a Laravel app.

2770.1k1](/packages/opgginc-codezero-laravel-localized-routes)[awes-io/localization-helper

Package for convenient work with Laravel's localization features

3527.1k4](/packages/awes-io-localization-helper)

PHPackages © 2026

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