PHPackages                             acacha/llum - 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. [Utility &amp; Helpers](/categories/utility)
4. /
5. acacha/llum

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

acacha/llum
===========

Llum (light in catalan language) illuminates your Laravel projects.

2.0.1(7y ago)10926.0k13[20 issues](https://github.com/acacha/llum/issues)MITPHPPHP ^7.1.3

Since Feb 10Pushed 7y ago5 watchersCompare

[ Source](https://github.com/acacha/llum)[ Packagist](https://packagist.org/packages/acacha/llum)[ RSS](/packages/acacha-llum/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (4)Versions (43)Used By (0)

llum
====

[](#llum)

Speed up you Github/Laravel development workflow illuminating packages with llum:

[![asciicast](https://camo.githubusercontent.com/9e16292fcefd7e5b4944158740083b720de04fe5d6423ed6ab394bd44e4118aa/68747470733a2f2f61736369696e656d612e6f72672f612f62796d356f64336a3671747168356c697638757778317179342e706e67)](https://asciinema.org/a/bym5od3j6qtqh5liv8uwx1qy4?speed=2&theme=solarized-dark&loop=1&autoplay=1&size=medium)

[![Total Downloads](https://camo.githubusercontent.com/e2c7fae5fb461e7d5d561c186871de10840038bafb0a198b9ef29327c58b8c91/68747470733a2f2f706f7365722e707567782e6f72672f6163616368612f6c6c756d2f646f776e6c6f6164732e706e67)](https://packagist.org/packages/acacha/llum)[![Latest Stable Version](https://camo.githubusercontent.com/0321c3e984eb2a4bc2025640b19ba12750e6b161a26795db91d990401ea1f555/68747470733a2f2f706f7365722e707567782e6f72672f6163616368612f6c6c756d2f762f737461626c652e706e67)](https://packagist.org/packages/acacha/llum)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/deb027f90edbd0f2499a3deb1d5010f81b468bbe0a16db26c7430a6264c12920/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f6163616368612f6c6c756d2f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/acacha/llum/?branch=master)[![Build Status](https://camo.githubusercontent.com/4b9f6c3a5f7a0804f689f62c02456b4516311e9a45447bcabac92a4ea5769350/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f6163616368612f6c6c756d2f6261646765732f6275696c642e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/acacha/llum/build-status/master)[![StyleCI](https://camo.githubusercontent.com/e7f5f2f2b58808d9c6b4218a894db78cb6d3a12b240b903180245fc7d29fcc57/68747470733a2f2f7374796c6563692e696f2f7265706f732f35313036393433392f736869656c643f6272616e63683d6d6173746572)](https://styleci.io/repos/51069439)[![Build Status](https://camo.githubusercontent.com/0eb233f2edb75a4343670df88cda1ff0c59449892ba1368692832d7262e77827/68747470733a2f2f7472617669732d63692e6f72672f6163616368612f6c6c756d2e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/acacha/llum)

Now supports Laravel 5.4.

See also:

-

Install notes
=============

[](#install-notes)

```
composer global require "acacha/llum=~1.0"
```

Requirements
============

[](#requirements)

Some commands use bash commands like [GNU sed](https://www.gnu.org/software/sed/) and touch.On Windows you can use [CygWin](https://www.cygwin.com/) or see [StackOverflow](http://stackoverflow.com/questions/127318/is-there-any-sed-like-utility-for-cmd-exe)

On MAC OS use GNU sed instead of default installed BSD sed

```
brew install gnu-sed --with-default-names
```

Commands
========

[](#commands)

init
====

[](#init)

Execute:

```
llum init
Please enter your github username (sergi) ?
Do you want to use our assistant to obtain token via Github API (Y/n)?Y
Github password?
```

To configure your Bithub user and obtain a token to interact with github using llum commands (see github command section below). This command creates file `~/.llumrc` , an example:

```
~ cat .llumrc
; Llum configuration file

[github]
username = acacha
token = token_here
token_name = your token name here
```

You can avoid providing password creating manually this file an putting your personal Github acces token () on `~/.llumrc` file.

Github
------

[](#github)

**IMPORTANT**: Requires previous execution of `llum init` command to work.

### github:init

[](#githubinit)

**IMPORTANT**: Requires previous execution of `llum init` command to work.

This commands initializes a Github repo, create a first commit, create a Github repo and syncs local content with Github repo. The commands executed are:

```
git init
git add .
git commit -a -m "Initial version"
llum github:repo
git pull origin master
git push origin master
```

Example:

```
$ cd myproject
$ llum github:init
Running command git init...
S'ha inicialitzat un buit dipòsit de Git a /home/sergi/myproject/.git/
Running command git add ....
Running command git commit -a -m "Initial version"...
[master (comissió d'arrel) 563473d] Initial version
 1 file changed, 0 insertions(+), 0 deletions(-)
 ...
Running command llum github:repo...
Repository myproject created
Running command git remote add origin git@github.com:acacha/myproject.git...
Running command git pull origin master...
fatal: Couldn't find remote ref master
Running command git push origin master...
Comptant els objectes: 3, fet.
Escrivint els objectes: 100% (3/3), 216 bytes | 0 bytes/s, fet.
Total 3 (delta 0), reused 0 (delta 0)
To git@github.com:acacha/myproject.git
 * [new branch]      master -> master
```

### github:repo

[](#githubrepo)

**IMPORTANT**: Requires previous execution of `llum init` command to work.

Create a new Github repo:

```
mkdir && cd newrepo
llum github:repo
```

This create a new Github repo called `{yourgithubusername}/newrepo` (the current folder name is used) . You can provide a name for the repo with:

```
llum github:repo reponame
```

boot
----

[](#boot)

Execute commands:

- devtools
- sqlite
- migrate
- serve

And your are ready to go!

devtools
--------

[](#devtools)

Install and configure amazing debug tools [Laravel Debugbar](https://github.com/barryvdh/laravel-debugbar) and [Laravel-ide-helper](https://github.com/barryvdh/laravel-ide-helper)

```
llum devtools
```

debugbar
========

[](#debugbar)

You can install only [Laravel Debugbar](https://github.com/barryvdh/laravel-debugbar) devtool with:

```
llum debugbar
```

idehelper
=========

[](#idehelper)

You can install only [Laravel-ide-helper](https://github.com/barryvdh/laravel-ide-helper) devtool with:

```
llum idehelper
```

sqlite
------

[](#sqlite)

Once you've installed a new laravel project use sqlite command to active sqlite

```
laravel new larapp
cd larapp
llum sqlite
File database/database.sqlite created successfully
.env file updated successfully
```

And sqlite is ready to go:

```
php artisan migrate
Migration table created successfully.
Migrated: 2014_10_12_000000_create_users_table
Migrated: 2014_10_12_100000_create_password_resets_table
```

provider
--------

[](#provider)

Add a provider to config/app.php file:

```
llum provider Acacha\AdminLTETemplateLaravel\Providers\AdminLTETemplateServiceProvider::class
```

alias
-----

[](#alias)

Add an alias/Facade to config/app.php file:

```
llum alias Socialite Laravel\Socialite\Facades\Socialite::class
```

serve
-----

[](#serve)

Similar to php artisan serve but some enhacements:

- First tyry to use port 8000 but if is already in use (in mi case so many times this occurs because Laravel homestead is up) then tries with following port numbers (8001, 8002, 8003)
- If sensible-browser command is available then starts browser

```
llum serve
Running php artisan serve --port=8002
Opening http://localhost:8002 with default browser
```

migrate
-------

[](#migrate)

Runs php artisan migrate

```
llum migrate
```

Packagist
=========

[](#packagist)

Troubleshooting
---------------

[](#troubleshooting)

### GNU sed on MAC OS

[](#gnu-sed-on-mac-os)

Acacha llum need GNU sed to work so replace BSD sed with GNU sed using:

```
brew install gnu-sed --with-default-names
```

Check you version of sed with:

```
man sed
```

sed GNU version path is:

```
$ which sed
/usr/local/bin/sed
```

Instead of default path of BSD sed (installed by default on MAC OS):

```
/usr/bin/sed
```

More info at [mdbootstrap/adminlte-laravel#58](https://github.com/mdbootstrap/adminlte-laravel/issues/58)

Working notes
=============

[](#working-notes)

Update value in .env file with sed:

```
sed -i '/^MAIL_DRIVER=/s/=.*/=log/' .env
```

Comment database entries:

```
sed -i 's/^DB_/#DB_/g' .env
```

Add sqlite before database entries:

```
sed 's/.*DB_HOST.*/DB_CONNECTION=sqlite\n&/' .env
```

Artisan serve always working:

```
$continue = true;
$port = 8000;
do {
    echo "Testing with port: ". $port;
    if (check_port($port)) {
        passthru('php artisan serve --port=' . $port);
        $continue=false;
    }
    $port++;
} while ($continue);

echo "END";
function check_port($port,$host = '127.0.0.1') {
    $fp = @fsockopen($host, $port,$errno, $errstr, 5);
    if (!$fp) {
        return true;
    } else {
        // port is open and available
        return false;
        fclose($fp);
    }
}
```

Solution with php preg\_replace function:

```
file_put_contents(base_path('.env'), preg_replace("/(MAIL_DRIVER)=(.*)/", "$1=log", file_get_contents(base_path('.env'))));
```

Insert provider in config/app.php file:

```
sed '/.*#llum_providers.*/a \\tBarryvdh\\LaravelIdeHelper\\IdeHelperServiceProvider::class,\n' config/app.php
```

###  Health Score

40

—

FairBetter than 88% of packages

Maintenance16

Infrequent updates — may be unmaintained

Popularity39

Limited adoption so far

Community19

Small or concentrated contributor base

Maturity70

Established project with proven stability

 Bus Factor1

Top contributor holds 94.8% 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 ~24 days

Recently: every ~115 days

Total

36

Last Release

2910d ago

Major Versions

0.7 → 1.02016-09-03

1.1.13 → 2.02018-03-12

PHP version history (3 changes)0.1PHP &gt;=5.5.9

1.1.12PHP &gt;=5.6.4

2.0PHP ^7.1.3

### Community

Maintainers

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

---

Top Contributors

[![acacha](https://avatars.githubusercontent.com/u/4015406?v=4)](https://github.com/acacha "acacha (182 commits)")[![scrutinizer-auto-fixer](https://avatars.githubusercontent.com/u/6253494?v=4)](https://github.com/scrutinizer-auto-fixer "scrutinizer-auto-fixer (4 commits)")[![mormy](https://avatars.githubusercontent.com/u/210259?v=4)](https://github.com/mormy "mormy (2 commits)")[![pjona](https://avatars.githubusercontent.com/u/170732?v=4)](https://github.com/pjona "pjona (2 commits)")[![bryant1410](https://avatars.githubusercontent.com/u/3905501?v=4)](https://github.com/bryant1410 "bryant1410 (1 commits)")[![clebersa](https://avatars.githubusercontent.com/u/7107733?v=4)](https://github.com/clebersa "clebersa (1 commits)")

---

Tags

devtoolsgithubgithub-apilaravellaravel-5-packagellumphplaravelscaffoldboilerplate

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/acacha-llum/health.svg)

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

###  Alternatives

[laravel/framework

The Laravel Framework.

34.6k509.9M17.0k](/packages/laravel-framework)[symfony/maker-bundle

Symfony Maker helps you create empty commands, controllers, form classes, tests and more so you can forget about writing boilerplate code.

3.4k111.1M568](/packages/symfony-maker-bundle)[laravel/dusk

Laravel Dusk provides simple end-to-end testing and browser automation.

1.9k36.7M259](/packages/laravel-dusk)[shlinkio/shlink

A self-hosted and PHP-based URL shortener application with CLI and REST interfaces

4.8k4.3k](/packages/shlinkio-shlink)[glhd/conveyor-belt

14797.0k](/packages/glhd-conveyor-belt)[asgardcms/asgardcms-installer

AsgardCms application installer.

2842.6k](/packages/asgardcms-asgardcms-installer)

PHPackages © 2026

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