PHPackages                             iammarjamal/transsfc - 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. iammarjamal/transsfc

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

iammarjamal/transsfc
====================

A Laravel package for translating Blade components directly within components using @TransSFCs(), auto-extracting texts into language files.

1.0.1(1y ago)115MITJavaScriptPHP ^8.4

Since Mar 23Pushed 1y ago1 watchersCompare

[ Source](https://github.com/iammarjamal/TransSFC)[ Packagist](https://packagist.org/packages/iammarjamal/transsfc)[ Docs](https://github.com/iammarjamal/transsfc)[ RSS](/packages/iammarjamal-transsfc/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (2)Dependencies (9)Versions (3)Used By (0)

 [![TransSFC](https://camo.githubusercontent.com/ec9727d5309da97850fd8011cd3b64753c27e35cf98245705fd51f91674cffc5/68747470733a2f2f62616e6e6572732e6265796f6e64636f2e64652f5472616e735346432e706e673f7468656d653d6461726b267061636b6167654d616e616765723d636f6d706f7365722b72657175697265267061636b6167654e616d653d69616d6d61726a616d616c2532467472616e73736663267061747465726e3d616e63686f727341776179267374796c653d7374796c655f31266465736372697074696f6e3d7472616e736c6174696e672b426c6164652b636f6d706f6e656e74732b6469726563746c792b77697468696e2b636f6d706f6e656e7473266d643d312673686f7757617465726d61726b3d3026666f6e7453697a653d313030707826696d616765733d68747470732533412532462532466c61726176656c2e636f6d253246696d672532466c6f676f6d61726b2e6d696e2e737667)](https://camo.githubusercontent.com/ec9727d5309da97850fd8011cd3b64753c27e35cf98245705fd51f91674cffc5/68747470733a2f2f62616e6e6572732e6265796f6e64636f2e64652f5472616e735346432e706e673f7468656d653d6461726b267061636b6167654d616e616765723d636f6d706f7365722b72657175697265267061636b6167654e616d653d69616d6d61726a616d616c2532467472616e73736663267061747465726e3d616e63686f727341776179267374796c653d7374796c655f31266465736372697074696f6e3d7472616e736c6174696e672b426c6164652b636f6d706f6e656e74732b6469726563746c792b77697468696e2b636f6d706f6e656e7473266d643d312673686f7757617465726d61726b3d3026666f6e7453697a653d313030707826696d616765733d68747470732533412532462532466c61726176656c2e636f6d253246696d672532466c6f676f6d61726b2e6d696e2e737667)

TransSFC
========

[](#transsfc)

TransSFC is a Laravel package for translating Blade components directly within components using `@TransSFC()`, auto-extracting texts into language files.

📌 Requirements
--------------

[](#-requirements)

- **Laravel** `^11`
- **Node.js** `^20`

🚀 Installation
--------------

[](#-installation)

You can install the package via Composer:

```
composer require iammarjamal/transsfc
```

📚 Usage
-------

[](#-usage)

### 1⃣ Start the Translation Watcher

[](#1⃣-start-the-translation-watcher)

Run the following command in the terminal to activate the Node.js watcher:

```
php artisan lang:serve
```

This watcher monitors Blade files and automatically extracts translatable text into Laravel's language files.

### 2⃣ Define Translations in Blade Files

[](#2⃣-define-translations-in-blade-files)

You can now use `@useTheme()` and `@TransSFC()` in any Blade file within the `resources/views` directory.

✨ Example Usage
---------------

[](#-example-usage)

```

   ...
   @useTheme('hello_world')

@TransSFC('ar')
[
   'hello_world' => 'اهلاً بالعالم',
]
@endTransSFC

@TransSFC('en')
[
   'hello_world' => 'Hello World',
]
@endTransSFC
```

🔍 How It Works
--------------

[](#-how-it-works)

1. **Translating Text**:

    - The `@useTheme('hello_world')` directive retrieves the corresponding translation for the active language.
    - The `@TransSFC('ar')` and `@TransSFC('en')` blocks define translations for Arabic (`ar`) and English (`en`).
2. **Automatic Language File Updates**:

    - The watcher reads these Blade files and updates the Laravel language files.
    - Translations are stored in `lang/[lang]/app.php` using the format `[sfc.pathBladeFile.key]`.

📝 Example of the Generated Language File (`lang/en/app.php`)
------------------------------------------------------------

[](#-example-of-the-generated-language-file-langenappphp)

```
return [
   'sfc.home.pages.index.hello_world' => 'Hello World',
];
```

This makes it easy to manage translations directly within Blade files while ensuring they are structured within Laravel's language system.

Credits
-------

[](#credits)

- [iammarjamal](https://github.com/iammarjamal)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE) for more information.

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance46

Moderate activity, may be stable

Popularity7

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity56

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 ~8 days

Total

2

Last Release

413d ago

### Community

Maintainers

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

---

Top Contributors

[![iammarjamal](https://avatars.githubusercontent.com/u/64818319?v=4)](https://github.com/iammarjamal "iammarjamal (11 commits)")

---

Tags

laraveliammarjamaltranssfc

###  Code Quality

TestsPest

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/iammarjamal-transsfc/health.svg)

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

###  Alternatives

[askdkc/breezejp

Laravel Starter Kit (Livewire+Breeze+Laravel UI+Jetstream)や標準のバリデーションメッセージを全て一瞬で日本語化し、言語切替機能も提供するパッケージです / This package provides all-in-one Japanese translation for Laravel StarterKit (Livewire StarterKit, Breeze, Laravel UI and Jetstream) packages and validation messages with language switching feature.

590244.8k1](/packages/askdkc-breezejp)[statikbe/laravel-filament-chained-translation-manager

A translation manager tool for Laravel Filament, that makes use of the Laravel Chained Translator.

92108.7k](/packages/statikbe-laravel-filament-chained-translation-manager)[vormkracht10/laravel-mails

Laravel Mails can collect everything you might want to track about the mails that has been sent by your Laravel app.

24149.7k](/packages/vormkracht10-laravel-mails)[elegantly/laravel-translator

All on one translations management for Laravel

6216.9k](/packages/elegantly-laravel-translator)[andrewdwallo/transmatic

Automate and streamline real-time text translations in your Laravel applications

5511.6k](/packages/andrewdwallo-transmatic)[smousss/laravel-globalize

Make Laravel projects translatable in a matter of seconds!

2266.3k](/packages/smousss-laravel-globalize)

PHPackages © 2026

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