Skip to content

Latest commit

 

History

History
147 lines (114 loc) · 7.42 KB

README.md

File metadata and controls

147 lines (114 loc) · 7.42 KB
Raw

Front-end / web performance optimisation starter kit

This starter kit has been created based on:

npm

In the starter kit you can see sample HTML, JS and SCSS files that are useful for students of the online course about web performance optimisation. Feel free to remove the files if you want to start using this boilerplate for your own project and initially optimise it using the build process.

A simple Gulp 4 Starter Kit for modern web development.

Features / Use Cases

This Gulp Starter Kit provides a simple way of setting up a modern web development environment. Here is a list of the current features:

  • Copy HTML files from src to dist directory
  • Compile Pug template files (.pug) from src to HTML files and put them inside dist directory
  • Compile CSS preprocessor code (Sass/SCSS, Less, Stylus) to CSS
  • Autoprefix and minify CSS and put it inside dist directory
  • Compile ES6+ to ES5, concatenate JS files and minify code
  • Compress and copy images into dist directory
  • Copy dependencies specified in package.json from src/node_modules directory into node_modules folder inside dist directory
  • Import dependencies into your application with ES6 modules
  • Spin up local dev server at http://localhost:3000 including auto-reloading

Requirements

This should be installed on your computer in order to get up and running:

Dependencies

These npm packages are used in the Gulp Starter Kit:

For more information, take a look at the package.json file or visit the linked npm package sites.

Getting started: git clone

The other way of downloading the Gulp Starter Kit is by cloning this Git repository. Before executing any commands, make sure you have Git installed on your computer.

Then, follow these instructions:

  1. Execute git clone https://github.com/bartekmis/frontend-optimisation-starter-kit your-project-name. This creates a folder called your-project-name (change that to your project name) at the current location where your terminal / command prompt is pointing to.
  2. Change your working directory to your project folder by executing cd your-project-name.
  3. Install all dependencies by executing npm install.
  4. Spin up your web development environment with the command npm start.
  5. Start coding!

If you are lazy, just do everything at once:

git clone https://github.com/bartekmis/frontend-optimisation-starter-kit your-project-name && cd your-project-name && npm install && npm start
  1. Many features of the build process is not enabled by default - look into gulpfile.js to see what processes are commented. Feel free to uncomment and start using them.

Usage / FAQ

What kinds of build scripts does the Gulp Starter Kit offer?

The Gulp Starter Kit offers two different build scripts:

  1. npm run build: This is used to build all files and run all tasks without serving a development server and watching for changes.
  2. npm start: This is the normal development script used to build all files and run all tasks, but also to serve a development server and watch for changes.

How can I use another CSS preprocessor than Sass?

In case you prefer to use one of the other supported CSS preprocessors over Sass, you can simply create a new directory src/assets/css-processor-name which is where all your CSS preprocessor files have to be placed. After you have moved all your code to the new folder, just make sure to delete the sass directory and everything should work as expected.

Here's a list of the currently supported CSS preprocessors and the corresponding directory names:

  • Sass (src/assets/sass)
  • SCSS (src/assets/scss)
  • Less (src/assets/less)
  • Stylus (src/assets/stylus)

How can I specify for which browsers CSS code should be autoprefixed?

The recommended way of specifying which browsers should be targeted by the CSS autoprefixer is to add a browserslist key to package.json:

{
  "browserslist": [
    "last 3 versions",
    "> 0.5%"
  ]
}

You can find more information on that topic in the README file of the employed PostCSS plugin.

What types of images are supported?

The following types of images are currently supported:

  • PNG
  • JPG / JPEG
  • GIF
  • SVG
  • ICO (not compressed)

How can I specify dependencies which are then copied to the dist folder?

You don't need to specify your dependencies anywhere else than in your package.json file. Just install your dependencies via npm and all your dependencies get automatically loaded and copied into the dist folder.

How can I load dependencies inside my application?

ES6 modules are supported by this Gulp Starter Kit. Just install your dependencies and import them like so:

import axios from 'axios';

Contributing

Feel free to contribute to this project! Any kinds of contributions are highly appreciated!

Please make sure to follow the process below in order to contribute to this project:

  1. Open an Issue to describe what you are about to do. You should make sure to get feedback as early as possile to ensure your work does not end up as waisted time.
  2. Fork this repository by clicking the fork button at the top of this page.
  3. Clone your newly created fork (git clone https://github.com/your-github-username/gulp-starter-kit.git).
  4. Make your changes and commit them to your forked repository.
  5. Once finished, open a detailed Pull Request describing your changes.
  6. Wait for your PR to be accepted and merged.

Versioning

This project uses the rules of semantic versioning. For more information, visit semver.org.

License

This project is licensed under the MIT License.