README

PostCSS Magento 2 system.

Requirements

1. Magento 2 CE installed
2. NodeJS (with npm package manager)
3. GulpJS $ npm install -g gulp (sudo may be needed for mac users)

Installation

1. Install via Composer: composer require trive/theme-frontend-strive or clone this repository under Magento /app/design/frontend/Trive/blank folder & StriveGulpTool inside Magento_root/strive-gulp folder.
2. bin/magento setup:upgrade
3. bin/magento setup:static-content:deploy
4. Install node_modules with npm install or yarn inside strive-gulp folder
5. Set up Gulp file paths inside gulpfile.

Features & Usage

• Fast css compilation thanks to PostCSS

• PostCSS theme fallback / child theme support

• Small (as possible) set of PostCSS base styles and settings needed to get a working development system. Hey, it looks somehow like a Magento base theme, right? ;)

• BrowserSync - instant css injecting into browser & weinre support

• Theme static content is watched & transferred directly into pub/static via Gulp. No need to use Magento content deploy during development.

• Added gulp clean and deploy tasks. If there is a need, gulp clean will remove everything in var/cache, var/generation, var/view_preprocessed & pub/static folder (Except .htaccess, magento blank & magento luma theme) and gulp deploy will deploy Magento static content (short of bin/magento setup:static-content:deploy).

• PostCSS plugins used on Strive (check npmjs for usage):

• postcss-import - PostCSS plugin to transform @import rules by inlining content.

• postcss-simple-vars - PostCSS plugin for Sass-like variables

• postcss-extend - As close to cssnext @extend as possible for PostCSS

• postcss-nested - PostCSS plugin to unwrap nested rules like how Sass does it.

• autoprefixer - Parse CSS and add vendor prefixes to CSS rules using values from the Can I Use website

• cssnano - A modular minifier, built on top of the PostCSS ecosystem.

• css-mqpacker - Pack same CSS media query rules into one media query rule.

• postcss-mixins - PostCSS plugin for mixins

• lost - LostGrid is a powerful grid system built in PostCSS that works with any preprocessor and even vanilla CSS.

• postcss-responsive-type - PostCSS plugin that adds responsive magic to font-size

• postcss-custom-media - PostCSS plugin to transform W3C CSS Custom Media Queries to more compatible CSS

• postcss-color-function - PostCSS plugin to transform W3C CSS color function to more compatible CSS.

Gulp

Creating a child theme

Gulpfile paths.cssSrc would be 'app/design/fronted/Trive/theme-name' and paths.cssDest: 'pub/static/frontend/Trive/theme-name/'. Child theme will need to have styles.css and settings.css inside the same folder structure like Strive (web/src/preCSS/), so it'll be needed to copy those two files from Trive/blank to child theme.

Override css files

'postcss-import' looks for imported css files inside Trive/theme-name and if it can't find them here, it'll look into Trive/blank. To override existing blank theme css file, add css file with same name and path in child theme. postcss-import will take it instead of Trive/blank css.

File override example: Trive/blank/web/src/preCSS/theme/icons.css -> Trive/theme-name/web/src/preCSS/theme/icons.css

Gulp Tasks

• gulp - Default gulp task (runs 'css', 'static', 'watch' & 'browser-sync' tasks). It watches css, html, images & js files. Browser-sync injects css file into the browser. These files, if changed, are auto transferred from theme to pub/static folder, so deployment of Magento static content would not be needed. Gulp-watch package is added to gulpfile so newly added files are watched also. This means it's not needed to restart gulp task anymore.

• gulp clean - Removes everything in var/cache, var/generation, var/view_preprocessed & pub/static folder (Except .htaccess, magento blank & magento luma theme)

• gulp deploy - It's a short of bin/magento setup:static-content:deploy. There is no problem to use longer option either :)

Update

• gulp upgrade - Short of 'bin/magento setup:upgrade'

• gulp deploy - Excluded Magento/blank & Mageto/luma by default. Faster deployment this way...

Demo

Working demo of Strive can be checked here: https://strive.public.trivedev.com/