Skip to content
This repository has been archived by the owner on Aug 11, 2021. It is now read-only.

Latest commit

 

History

History
68 lines (45 loc) · 3.09 KB

README.md

File metadata and controls

68 lines (45 loc) · 3.09 KB
Development Preprod Production
CircleCI CircleCI CircleCI

ingenie Insurance Wordpress Theme

ingenie WordPress theme using TailwindCSS and Laravel Mix.

Getting started:

  1. cd into ingenie2020 theme directory
  2. Run npm install
  3. Duplicate the local-example.json file to local.json, then replace the proxy value with your local development hostname
    • This will allow you to use live reload/injection while working on your CSS/JS
  4. Once theme is dropped into your local development site just activate the theme
  5. Run npm run dev and start coding

Commands

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.

npm run webpack

Runs the development build

npm run prod

Runs the product build which includes asset file versioning and Purge CSS

Versioned Assets (production)

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. 😁👍

Purge CSS (production)

Purge CSS is pretty darn excellent and is used to strip out any CSS that isn't being used during the production build.

It does this by looking through specified template files to work out which CSS selectors have been used. If it can't find a CSS rule being used in the templates, it removes it from the final CSS.

See the paths option in the mix.purgeCss() invocation in webpack.mix.js for the file paths being looked at.

How to tell Purge CSS to ignore things

The easiest way is to delineate your CSS with comments as per the example below. See whitelisting for more options.

/* purgecss start ignore */
h1 {
  color: blue;
}

h3 {
  color: green;
}
/* purgecss end ignore */

Deployment

Work in progress but currently if checked into github a shippable build starts and runs the #### npm run prod script. It is then deplyed to the master branch on the new ingenie website we are building out. Work in progress...