benjamest / wp-laravel-mix-theme-boilerplate

A minimalist boilerplate for WordPress theme development using Laravel Mix

A minimalist boilerplate for WordPress theme development using Laravel Mix.

Getting started:

1. Clone into an empty theme directory
2. cd into your new theme directory
3. Run npm install
4. Copy the local-example.json file to local.json and replace the proxy value with your local development hostname
   • This will allow you to use live reload/injection while working on your CSS/JS

To Start Development

Run npm run dev

Assets will be compiled and BrowserSync will proxy the dev host allowing you to work while seeing your CSS and JS changes appear on the site as they are recompiled.

To Prepare Assets for Deployment

Run npm run prod

This will prepare versioned assets and sourcemaps for your CSS and JS files.

Versioned Assets

Versioned assets will appear in a build directory alongside a manifest file which is used while enqueuing scripts and styles. This saves you the need to adjust version parameters on your assets and makes it possible to remove parameters on asset URLs without losing the ability to force those assets to update in browsers.