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





Installs: 25 767

Dependents: 1

Suggesters: 0

Security: 0

Stars: 108

Watchers: 5

Forks: 13

Open Issues: 19

2.0.1 2018-05-29 10:58 UTC


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


Total Downloads Latest Stable Version Scrutinizer Code Quality Build Status StyleCI Build Status

Now supports Laravel 5.4.

See also:

Install notes

composer global require "acacha/llum=~1.0"


Some commands use bash commands like GNU sed and touch.On Windows you can use CygWin or see StackOverflow

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

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




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

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.


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


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


$ 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
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)
 * [new branch]      master -> master


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


Execute commands:

  • devtools
  • sqlite
  • migrate
  • serve

And your are ready to go!


Install and configure amazing debug tools Laravel Debugbar and Laravel-ide-helper

llum devtools


You can install only Laravel Debugbar devtool with:

llum debugbar


You can install only Laravel-ide-helper devtool with:

llum idehelper


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


Add a provider to config/app.php file:

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


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

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


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


Runs php artisan migrate

llum migrate



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

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


More info at

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);
} while ($continue);

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

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