README

Fork of eolant/silverstripe-bootstrap-mix as an example for using silverstripe-mix

This is a boilerplate base theme for SilverStripe 4 that you can use for all your custom Boostrap 4 themes.
It uses Laravel Mix for assets compilation and hot module reloading for quick and easy development allowing you to focus on the task at hand, not worrying about front end tools.
Includes a SASS and React example, but can easily be replaced for anything else such as SASS, LESS, Stylus, Vue, etc.
Refer to the laravel-mix documentation for more details.

Installation

composer require ssmix/bootstrap-theme

• Update themes in app/_config/theme.yml

  SilverStripe\View\SSViewer:
    themes:
      - ssmix-bootstrap
      - '$public'
      - '$default'

• Run yarn install from the theme directory

Usage

• yarn hot watch for development
• yarn build for production build

Please refer package.json for all commands.

Renaming theme

If you want to rename the theme, create extras.expose key in your root composer.json
Replace <theme-name> with the new name

"extra": {
  "expose": [
      "themes/<theme-name>/dist",
      "themes/<theme-name>/css"
    ]
}

Then run vendor expose to generate the correct symlinks. See silverstripe/vendor-plugin and the SilverStripe Requirements docs for more information on vendor expose.

composer vendor-expose