Starter Project — a set of latest best practices packed in Gulp tasks

This article is the very first article in a series about , a set of latest best practices packed in Gulp tasks. In this article, I am going to explain the idea behind this project, how it could help you on your project and how to use it. Starter Project First Scenario Every project has its environment. Switching between projects means switching environments. Switching environments means remembering commands for running project tasks, like Gulp or webpack. But too often commands are forgotten. This scenario happens to me daily, even when working on similar projects. Second Scenario Consider two different projects. First is custom Wordpress theme development, second is Middleman blog. Both projects use Gulp task runner to compile and optimize assets. Setting up Gulp tasks for either project is time-consuming work. And every project has its architecture which disables a developer to copy Gulp tasks from one project to another without spending the time to reconfigure every Gulp task individually. Third Scenario Working on a project without a coding convention could be a nightmare. Git conflicts on every merge, endless discussion about tabs versus spaces, ugly and inconsistent code are just some of the problems that could emerge as a consequence. The idea I am sure these scenarios sound familiar. These happened to me a lot of times. I cannot even remember how many times I created a Sass mixin or a JavaScript function on a project that I wanted to use on another project but I was too lazy to search for the code, and eventually, I started from the beginning. Starter Project is an effort of mine to fix these problems. It is a collection of Gulp tasks with the latest best practices in front-end development. But not only Gulp tasks. It contains every asset for building a successful project, from HTML and CSS to JavaScript and images. The Package The package is available on . You could find instructions for the installation in . Once installed, you will have the copy of the package’s website for the Starter project. It could be a good starting point for your new project. npm official documentation Starter Package is also a static page generator, a very rudimental one. The original website is built using Starter Project and hosted on Netlify. It is very fast, see the and scores. PageSpeed Insights WebPageTest The package should be used as a development dependency. That will allow you to update the package and maintain your project more efficiently. package.json example The Usage Starter project has three different Gulp commands for different environments: and for a development build, gulp dev gulp dist for documentation build, and gulp docs for a production build. gulp To learn more about commands, see . official documentation With Starter Project you get the architecture for: HTML, CSS, JavaScript, images (.png, .jpg, .svg), favicons, fonts, and more. You could find all assets in folder. Once you run one of the build commands, folder will be created with compiled static contents. Learn more about structure . new_src new_dist here The Config file Starter Project is configurable and should be able to run in every project, no matter the architecture. The main configuration file could be found in the root of the project, . For every task, there is an option . If set to true, the task will run. For example, you could turn off , a library for generating Critical CSS. config.json run [penthouse](https://www.npmjs.com/package/gulp-penthouse) config.json example Read more about configuration . here Features I mentioned Critical CSS in the previous section. Starter Project has other great features. Pug is default template engine. Markdown is also supported via Pug filter . I should consider adding support for more template engines if interest is shown. jstransformer-markdown-it Sass comes with , and libraries by default. It will help you create more consistent pages with strictly defined typography and media queries. normalize.css modularscale-sass sass-mq Starter Project supports ES6 via babel plugin. You will find scripts for deferred loading of CSS files (use it in combination with Critical CSS) and for loading fonts with . Critical FOFT method If you are not using a third-party service for hosting images, then Starter Project could optimize your images. Starter Project supports , , , and files. .gif .png .jpg .svg Documentation is an integral part of every project. You can generate excellent documentation using Starter Project. will parse Sass comments and create Sass documentation. will parse JavaScript comments and create JavaScript documentation. You could even create living styleguide. Starter Project uses to parse Sass comment for that purpose. SassDoc JSDoc KSS There are other goodies, like Browser-sync, Favicons, Sourcemaps, Gzip, Linters, Standards, editorconfig, and more. I will try to document everything and write new articles about these, too. Stay tuned! Websites I have used Starter Project on several different projects so far. — a website with a blog for Han Han Xue, a Designer and FX Technical Director from Montreal, Canada. The site runs on Middleman. Han Han Xue website — a website for Irina and Matej, wedding and portrait photographers based in Croatia. The site runs on WordPress. Irina & Matej website — a personal website with a blog. The site runs on Hexo. Silvestar Bistrović website — a website for Starter Project. The website runs on Starter Project only. Starter Project website Conclusion Starter Project is not conceived as a strict set of rules. This package should be configured to fulfill every project specification; you could propose new features, fork the repository or turn off some of the tasks in the config file. Show your support: provide feedback, open , create , or leave a comment. a new issue a new pull request Originally published at www.silvestarbistrovic.from.hr .