Skip to content

Glorian/laravel-elixir-webpack-advanced

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

87 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

laravel-elixir-webpack-advanced

Simple extension to laravel elixir to build javascript bundle with webpack.

Install

npm install --save-dev laravel-elixir-webpack-advanced

Features

  • ES6-loader with Babel
    • source maps
    • multiple bundles
    • shared modules
  • Bower dependency resolver
    • you can add any bower package to your application like you did with npm
    • images will be resolved automatically and placed in (plublicPath / js.outputFolder / <-name of bower package->)
    • css (with correct assets path) will be extracted to plublicPath / js.outputFolder / <-name of main entry point->.css
  • HTML loader
    • you can require any html template in your js-application
  • Stylus and Sass|Scss loaders
  • Native watcher
    • if you start gulp watch - webpack task will started in watch mode, so any further changes of application files would not restart webpack task

Usage

Example Gulpfile:

var elixir = require("laravel-elixir"),
	config = elixir.config;

// Here you can override default elixir configuration
// config.assetsPath = 'path/to/assets/dir';
// ...

require("laravel-elixir-webpack-advanced");

elixir(function(mix) {
    mix.webpack("app.js");
});

First argument is the entry point[s] of your application (default directory is resources/assets/js). In second argument you could pass webpack options. In production mode, bundle will be compressed. Third argument - object for webpack.ProvidePlugin.

Advanced example

/**
* If you wish to add some vendor libs to your project - you can redefine `entry` option 
* in webpack config: `entry: { vendor: ['jquery', 'vue', ...] }`
* This list of libraries will be bundled into `vendor.js`
*/

elixir(function(mix) {
    mix.webpack(
    	/**
    	* You can simply write string: 'app' or 'app.js' => output: main.js
    	* or object: { bundle: 'app.js' } ...
    	*/
        { bundle: 'app.js' }, // Output will be: bundle.js
        {
        	entry: {
        		// before start gulp task - you should install jquery (or other libs) by npm or bower
        		vendor: ['jquery'] 
        	},
	        output: {
	        	// By default: `/${config.js.outputFolder}/` - (/js/)
            		publicPath: `/assets/${config.js.outputFolder}/` // Browser output path: /assets/js/
            	}
        }, 
        /** 
        * Global variables for vendor libs
        * No need to require jquery in all your modules
        */
        {
            $: 'jquery',
            jQuery: 'jquery',
            'window.jQuery': 'jquery'
        }
    );
});

Things to do:

  • Implement HMR
  • Isolate inner configuration from mutation

License

MIT (http://www.opensource.org/licenses/mit-license.php)

About

Laravel Elixir Webpack Extension (improved)

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 3

  •  
  •  
  •