103

Product support

Visit this product's website for support.

Categories

Starter development template for building Zurb Foundation 5 themed OctoberCMS sites.

Includes:

Installation

Add the theme to existing project while logged into OctoberCMS account online, or interactively by searching it inside Settings/System/Updates/Themes in backend, or with the following command-line instructions inside project root:

php artisan theme:install castus.f5fresh f5fresh
php artisan theme:use f5fresh

One-time Development Environment Setup

Install NodeJS and Node Package Manager globally (LTS version required). Run the following command-line instructions inside theme root:

npm install --global gulp-cli bower
npm i

Integrating build process into OctoberCMS project is easy - copy (or merge into existing) files into project root:

gulpfile.js
package.json

Adjust paths.root configuration variable to themes/castus-f5fresh/ and start using command-line tasks from project root.

Using and Editing

Check styleguide/default layout for example HTML page structure and mandatory includes. Custom styles example source is in assets/scss/styleguide SCSS, scripts in assets/es6/styleguide JS. Development changes can be automated with command-line instruction inside theme root:

gulp watch

Build versioned, optimized, minified, autoprefixed assets with command-line instruction inside theme root:

gulp upbuild --production

Customizing Foundation

Global Foundation styling parameters should be overriden in assets/scss/_settings553 SCSS.

Comment out unwanted styles and scripts for leaner and faster Foundation custom build:

For in-depth customizations follow Zurb's guide: How to Make Foundation 5 Your Own

1.4.0

Updated NPM dependencies, switched back to NPM from Yarn

Sep 11, 2019

1.3.0

Replaced gulp-imagemin with gulp-responsive for image optimization

Nov 26, 2018

1.2.1

Switched to original unminified Modernizr 2.8.3

Oct 17, 2018

1.2.0

Refactored Gulp build to use NPM package configuration (with "not dead" browserslist)

Jun 12, 2018

1.1.1

Fixed needless sourcemaps minification in Gulp task

Jan 31, 2018

1.1.0

Added Gulp task to increment build number, preloaded Bower vendor assets

Jul 14, 2017

1.0.2

Added intro page, enabled Yarn package manager

Mar 31, 2017

1.0.1

Added theme customization (site_name, brand_color)

Oct 19, 2016

1.0.0

Style guide default layout

Jan 23, 2016

0.9.2

Composite layout with partials, kitchen-sink intro page for testing style changes

Jan 23, 2016

0.9.1

Initial F5fresh theme with Gulp-built frontend resources.

Jan 23, 2016