jefrydco / uirev

A Painless Front-end Boilerplate Kit

Home Page:https://github.com/jefrydco/uirev

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

uirev

Overview

Uirev is a painless front-end boilerplate kit. It can make your developing experience more easy and fast.

Features

Feature Summary
Responsive boilerplate A responsive boilerplate optimized for the multi-screen web. Powered by Twitter Bootstrap.
Pug suppoprt Compile Pug into HTML with ease, write Pug syntax and mix it with Javascript to give more freedom. (Run gulp pug to compile)
Sass support Compile Sass into CSS with ease, bringing support for variables, mixins and more. (Run gulp scss:dev for developing or gulp scss:build for production)
Image compression Never think about compressing your image manually, just copy your image into assets/img and it'll be compressed automatically. Thanks to imagemin for such a great tool.
ECMAScript 6 Write in new generation of Javascript with a lot of syntactic sugar.
Live Browser Reloading Reload the browser in real-time whenever you edit your file without any need of extension. Brought to you by Browsersync. (Run npm run serve for developing or npm run build for production)

Quickstart

Make sure you have installed node.js on your computer. Download the kit or clone this repository. Run npm install to make everything run smoothly. Then, build your project in ./src directory.

To change between developing and production environment, take a look in ./src/pug/_env.pug. The default configuration is dev environment but you set it true if you wanna use production environment.

Available Command

Font

  • gulp fonts to copy all fonts in ./src/assets/scss/fonts to ./dist/assets/fonts.

Image

  • gulp img:hd to optimize and resize all images in ./src/assets/img/hd to resolution 1920 x auto. It also convert them into .jpg format.
  • gulp img:md has same functiont as gulp img:hd but the differences is it resize the image to resolution 1320 x auto.
  • gulp img:sm to optimize all images in ./src/assets/img/sm. It doesn't resize and convert anything because I think small image usually used for background pattern, icon and logo.
  • gulp img to run all of img command above.

JavaScript

  • gulp js:vendor-cp to copy all JS vendor assets in ./src/assets/js/vendor/cp to ./dist/assets/js.
  • gulp js:dev-vendor to convert all of vendor script into ECMAScript 5 then concat them into one file named vendor.js.
  • gulp js:dev to convert main.js into ECMAScript 5 and it also run js:vendor-cp and js:dev-vendor.
  • gulp js:build to convert all of vendor script and your main.js into ECMAScript 5 and concat them into one file named vendor.min.js.

SCSS

  • gulp scss:dev-vendor to compile all SCSS vendor assets in ./src/assets/scss/vendor to CSS files and place the output to ./dist/assets/css. It also combine all separated media queries found in them.
  • gulp scss:dev to compile all SCSS Vendor assets and your custom stylesheet.
  • gulp scss:build-vendor, it has same function as gulp scss:dev-vendor but the differences is it combine all SCSS files into one css file named vendor.min.css.
  • gulp scss:build, it has same function as gulp scss:dev.

Pug

  • gulp pug to compile and combile all pug files in ./src/pug into one file named index.html.

Helper

  • npm run clean or gulp clean to clean your dist project directory.
  • npm run serve or just gulp to run all of dev command above then serve it as localhost server.
  • npm run build or gulp build, it has same function as npm run serve but the differences is it run all of build command.

License

The content of this project itself is licensed under the Creative Commons Attribution 3.0 license, and the underlying source code used to format and display that content is licensed under the MIT license.

About

A Painless Front-end Boilerplate Kit

https://github.com/jefrydco/uirev

License:MIT License


Languages

Language:JavaScript 79.6%Language:HTML 11.5%Language:CSS 8.8%