customization.md

Customization

You can change several parts of Mercurius, like any other Laravel package.

Publish Views

php artisan vendor:publish --tag=mercurius-views

Views are published at /resources/views/vendor/mercurius/.

Styles (SASS)

1. Publish .scss files:

php artisan vendor:publish --tag=mercurius-sass

Will publish .scss files at /resources/sass/vendor/mercurius/.

2. WebPack config

Open the webpack.mix.js and place the following:

mix.sass('resources/sass/vendor/mercurius/mercurius.scss', 'public/vendor/mercurius/css/mercurius.css')
   .options({processCssUrls: false});

JavaScript

1. Publish .js and .vue files:

php artisan vendor:publish --tag=mercurius-js

Will publish JS files at /resources/js/vendor/mercurius/.

2. WebPack config

Open webpack.mix.js and place the following:

mix.js('resources/js/vendor/mercurius/bootstrap.js', 'public/vendor/mercurius/js/mercurius.js');

3. Add node packages

Open package.json file and make sure you're using the listed packages:

    "devDependencies": {
        "axios": "^0.18",
        "babel-core": "^6.26.0",
        "babel-loader": "^7.1.2",
        "babel-polyfill": "^6.26.0",
        "babel-preset-env": "^1.6.1",
        "bootstrap": "^4.1.3",
        "bootstrap-vue": "^2.0.0-rc.11",
        "cross-env": "^5.1",
        "jquery": "^3.2",
        "laravel-echo": "^1.4.0",
        "laravel-mix": "^2.0",
        "lodash": "^4.17.5",
        "moment": "^2.19.4",
        "popper.js": "^1.12",
        "promise": "^7.1.1",
        "pusher-js": "^4.3.1",
        "sass-loader": "^6.0.6",
        "sweetalert": "^2.1.0",
        "underscore": "^1.8.3",
        "urijs": "^1.19.1",
        "vue": "^2.5.13",
        "vue-axios": "^2.0.2",
        "vuescroll": "^4.8.12",
        "webpack": "3"
    }

4. Install node modules, by typing:

yarn install

Assets Management

For building assets for development and production, type one of the commands, respectively:

npm run dev
npm run prod

Note on WebPack config

If you are changing both SASS and JS files, the webpack.mix.js file should look like this:

mix.js('resources/js/mercurius/bootstrap.js', 'public/vendor/mercurius/js/mercurius.js')
   .sass('resources/sass/mercurius/mercurius.scss', 'public/vendor/mercurius/css/mercurius.css')
   .options({processCssUrls: false});

Copyright and license

Copyright 2018 Bruno Torrinha. Mercurius is released under the MIT License.