laravel-bundler

Laravel Bundler

Modern asset building tool for Laravel framework with better defaults.

Installation

:warning: This package does not work with laravel-mix; you should remove laravel-mix before using this one

# npm
npm install laravel-bundler 

# yarn
yarn add laravel-bundler

Usage

Create a webpack.config.js file on your project root and remove webpack.mix.js if exists.

module.exports = require('laravel-bundler')({
  entry: {
    app: './resources/js/app.js',
  },
});

Update your package.json

"scripts": {
    "dev": "cross-env NODE_ENV=development webpack --progress --mode development",
    "watch": "npm run dev -- --watch",
    "prod": "cross-env NODE_ENV=production webpack --progress --mode production",
    "hot": "cross-env NODE_ENV=development webpack-dev-server --progress --hot"
  },

Update your blade template

<!-- header -->
<link href="{{ mix('css/app.css') }}" rel="stylesheet">

<!-- footer -->
<script src="{{ mix('js/manifest.js') }}"></script>
<script src="{{ mix('js/vendor.js') }}"></script>
<script src="{{ mix('js/app.js') }}"></script>

Update your .gitignore

/public/hot
/public/js
/public/css
/public/fonts
/public/images
/public/mix-manifest.json

Baked Features

• Webpack 4, Babel 7 with @babel/preset-env
• Vue.js support
• CSS|SASS|SCSS support
• Font and image files handling
• HMR support, even for CSS :fire:
• Extract all css to a separate file based on entry name
• Extract all vendor js to a file
• PostCSS loader with autoprefixer and cssnano
• Clean output directories before build
• mix-manifest.json compatible with Laravel's mix() helper
• Load environment variables from .env file that are prefixed with MIX_
• SourceMap support in development

Documentation

• Wiki in progress

Not in the plan

These features are not in the plan but can be enabled on demand

• OS Notification
• PurgeCSS
• BrowserSync
• Copy files and folder
• Image compression
• CSS Preprocessors other than sass|scss
• Non webpack methods like minify|combine|babel|standaloneSass etc
• Babel plugins

License

MIT License

Changelog

0.7.0

• vue-template-compiler is a dev dependencies now, you should install this in your project manually in order to add support for Vue.js