angular-gulp-boilerplate

Clean but full-featured AngularJS boilerplate using Gulp workflow and best practices

Usage no npm install needed!

<script type="module">
  import angularGulpBoilerplate from 'https://cdn.skypack.dev/angular-gulp-boilerplate';
</script>

README

Angular Gulp Boilerplate

NpmVersion CI CD

Clean AngularJS boilerplate powered by Gulp tasks and designed to automate your daily development routine such as concatenation, obfuscation, minimisation and injection of templates, scripts, styles, translations and more.

As a result of using this boilerplate, your entire AngularJS project will be delivered to end users in a small bunch of files: index.html, scripts and styles split to app-related and vendor-related, translations and source maps.

Teaser

What you will get?

AngularJS npm Gulp Bower Browsersync Babel ESLint Sass Autoprefixer Normalize.css UI-Router angular-translate

AngularJS with UI-Router to manage routing, preconfigured angular-translate and helper packages to implement native dynamic localization and internationalization in a component-based approach, ng-annotate to add dependency injection annotations, $templateCache to encapsulate HTML templates in the app JavaScript bundle.

Bower with Wiredep to automate vendor dependencies injecting into the app scripts and styles.

A bunch of Gulp tasks to manage templates, scripts, styles, assets, translations, source maps, and to prepare the app for production deployment.

Browsersync for live reloading and synchronised testing across browsers and devices.

Babel to transpile ES2015 and beyond to vanilla JavaScript.

ESLint with AngularJS plugin to lint your code online and keep it clean.

Sass compiler with Autoprefixer and Normalize.css.

Quick start

Boilerplate exists in Node.js environment, so you need to install Node.js from official website or use NVM (NVM for Windows) first.

Attention! This project still uses Gulp 3 which is not supported by Node 12.

After setting up Node.js you can use npm (Yarn is an alternative) to install Bower and Gulp globally:

npm install -g bower gulp-cli

Install

Clone repository from GitHub:

git clone https://github.com/loginov-rocks/Angular-Gulp-Boilerplate.git MyProject

Jump into MyProject directory and install dependencies from npm registry:

cd MyProject
npm install

Next, install dependencies from Bower registry:

bower install

And that's it!

Use

Execute Gulp serving task to check if everything is fine:

gulp serve

Your default browser will be launched at http://localhost:3000 serving project. See other Gulp tasks and npm scripts you can use below.

Global install

Alternatively, you can delegate repository cloning to the package itself. Just install it globally as with Bower and Gulp:

npm install -g angular-gulp-boilerplate

Having this package installed globally, you can use the following command to clone the repository into your current directory:

angular-gulp-boilerplate

Or you can specify directory name to clone into as an argument:

angular-gulp-boilerplate MyProject

This command checks out the same version as you have installed globally. So if a new version is released, you can update package with the following command:

npm update -g angular-gulp-boilerplate

Gulp tasks

Most used

  • gulp serve or npm start - Build project, start watching for all changes and serve it using Browsersync.
  • gulp default or npm run build - Clean used directories and build production version ready to deploy.

Other

  • gulp build - Build production version ready to deploy.
  • gulp build-app - Build production version of app only, without assets.
  • gulp clean - Clean distribution and temporary directories.
  • gulp fonts - Copy and flatten fonts from Bower packages to distribution dir.
  • gulp inject - Inject scripts and styles into HTML entry.
  • gulp inject:reload - Start inject task and launch Browsersync reloading after.
  • gulp locales - Build locales.
  • gulp locales-angular - Build Angular locales only.
  • gulp locales-angular:dist - Build Angular locales only to distribution dir.
  • gulp locales:dist - Build locales to distribution dir.
  • gulp locales:watch - Build locales and watch for changes.
  • gulp other - Copy various not handled stuff to distribution dir.
  • gulp partials - Create template cache from HTML partials.
  • gulp scripts - Build scripts.
  • gulp scripts:clean - Clean temporary scripts.
  • gulp scripts:watch - Build scripts and watch for changes.
  • gulp serve:dist or npm run start:dist - Build production version and serve it using Browsersync.
  • gulp styles - Build styles.
  • gulp styles:watch - Build styles and watch for changes.
  • gulp watch - Build project and watch for all changes.

Npm scripts

npm scripts are not related to the development flow itself, but can be helpful to keep your project up to date.

  • npm run docs:gulp - Make markdown file containing Gulp tasks description as in the list above.
  • npm run lint - Lint JavaScript files.
  • npm run update:bower - Update dependencies versions in bower.json to the latest.
  • npm run update:dev - Update dependencies versions in package.json to the latest.

After updating dependencies versions you actually need to install them, do it with the following commands:

bower install
npm install

Credits

Awesome generator-gulp-angular was used as a basis for this project, especially Gulp tasks. This generator is unmaintained for a long time, I refactored it, implemented new features and try to keep all dependencies up to date, since it's used in my own production projects.