{"id":16218679,"url":"https://github.com/loginov-rocks/angular-gulp-boilerplate","last_synced_at":"2025-07-11T00:37:24.383Z","repository":{"id":56041264,"uuid":"73115313","full_name":"loginov-rocks/Angular-Gulp-Boilerplate","owner":"loginov-rocks","description":"Clean but full-featured AngularJS boilerplate using Gulp workflow and best practices","archived":false,"fork":false,"pushed_at":"2021-03-13T13:04:19.000Z","size":2082,"stargazers_count":29,"open_issues_count":0,"forks_count":17,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-06-29T16:04:04.825Z","etag":null,"topics":["angular-locales","autoprefixer","babel","browsersync","concatenation","es2015","es6","i18n","internationalization","l10n","lint","localization","minimisation","sass","seed","skeleton","sourcemaps","ugify","uglification","watch"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/angular-gulp-boilerplate","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/loginov-rocks.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-11-07T19:55:23.000Z","updated_at":"2022-05-26T18:35:29.000Z","dependencies_parsed_at":"2022-08-15T12:00:54.719Z","dependency_job_id":null,"html_url":"https://github.com/loginov-rocks/Angular-Gulp-Boilerplate","commit_stats":null,"previous_names":[],"tags_count":25,"template":true,"template_full_name":null,"purl":"pkg:github/loginov-rocks/Angular-Gulp-Boilerplate","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/loginov-rocks%2FAngular-Gulp-Boilerplate","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/loginov-rocks%2FAngular-Gulp-Boilerplate/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/loginov-rocks%2FAngular-Gulp-Boilerplate/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/loginov-rocks%2FAngular-Gulp-Boilerplate/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/loginov-rocks","download_url":"https://codeload.github.com/loginov-rocks/Angular-Gulp-Boilerplate/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/loginov-rocks%2FAngular-Gulp-Boilerplate/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264697567,"owners_count":23650955,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["angular-locales","autoprefixer","babel","browsersync","concatenation","es2015","es6","i18n","internationalization","l10n","lint","localization","minimisation","sass","seed","skeleton","sourcemaps","ugify","uglification","watch"],"created_at":"2024-10-10T11:50:17.719Z","updated_at":"2025-07-11T00:37:24.046Z","avatar_url":"https://github.com/loginov-rocks.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Angular Gulp Boilerplate\n\n[![NpmVersion](https://img.shields.io/npm/v/angular-gulp-boilerplate.svg)](https://www.npmjs.com/package/angular-gulp-boilerplate)\n[![CI](https://github.com/loginov-rocks/Angular-Gulp-Boilerplate/actions/workflows/ci.yml/badge.svg)](https://github.com/loginov-rocks/Angular-Gulp-Boilerplate/actions/workflows/ci.yml)\n[![CD](https://github.com/loginov-rocks/Angular-Gulp-Boilerplate/actions/workflows/cd.yml/badge.svg)](https://github.com/loginov-rocks/Angular-Gulp-Boilerplate/actions/workflows/cd.yml)\n\nClean AngularJS boilerplate powered by Gulp tasks and designed to automate your daily development routine such as\nconcatenation, obfuscation, minimisation and injection of templates, scripts, styles, translations and more.\n\nAs a result of using this boilerplate, your entire AngularJS project will be delivered to end users in a small bunch of\nfiles: `index.html`, scripts and styles split to app-related and vendor-related, translations and source maps.\n\n![Teaser](https://raw.githubusercontent.com/loginov-rocks/Angular-Gulp-Boilerplate/main/docs/teaser.png)\n\n## What you will get?\n\n[![AngularJS](https://raw.githubusercontent.com/loginov-rocks/Angular-Gulp-Boilerplate/main/docs/angular.png)](https://angularjs.org)\n[![npm](https://raw.githubusercontent.com/loginov-rocks/Angular-Gulp-Boilerplate/main/docs/npm.png)](https://www.npmjs.com)\n[![Gulp](https://raw.githubusercontent.com/loginov-rocks/Angular-Gulp-Boilerplate/main/docs/gulp.png)](https://gulpjs.com)\n[![Bower](https://raw.githubusercontent.com/loginov-rocks/Angular-Gulp-Boilerplate/main/docs/bower.png)](https://bower.io)\n[![Browsersync](https://raw.githubusercontent.com/loginov-rocks/Angular-Gulp-Boilerplate/main/docs/browsersync.png)](https://browsersync.io)\n[![Babel](https://raw.githubusercontent.com/loginov-rocks/Angular-Gulp-Boilerplate/main/docs/babel.png)](https://babeljs.io)\n[![ESLint](https://raw.githubusercontent.com/loginov-rocks/Angular-Gulp-Boilerplate/main/docs/eslint.png)](https://eslint.org)\n[![Sass](https://raw.githubusercontent.com/loginov-rocks/Angular-Gulp-Boilerplate/main/docs/sass.png)](https://sass-lang.com)\n[![Autoprefixer](https://raw.githubusercontent.com/loginov-rocks/Angular-Gulp-Boilerplate/main/docs/autoprefixer.png)](https://autoprefixer.github.io)\n[![Normalize.css](https://raw.githubusercontent.com/loginov-rocks/Angular-Gulp-Boilerplate/main/docs/normalize.png)](https://necolas.github.io/normalize.css)\n[![UI-Router](https://raw.githubusercontent.com/loginov-rocks/Angular-Gulp-Boilerplate/main/docs/ui-router.png)](https://ui-router.github.io)\n[![angular-translate](https://raw.githubusercontent.com/loginov-rocks/Angular-Gulp-Boilerplate/main/docs/angular-translate.png)](https://angular-translate.github.io)\n\n[AngularJS](https://angularjs.org) with [UI-Router](https://ui-router.github.io) to manage routing, preconfigured\n[angular-translate](https://angular-translate.github.io) and helper packages to implement native dynamic localization\nand internationalization in a component-based approach, [ng-annotate](https://www.npmjs.com/package/ng-annotate) to add\ndependency injection annotations, [$templateCache](https://docs.angularjs.org/api/ng/service/$templateCache) to\nencapsulate HTML templates in the app JavaScript bundle.\n\n[Bower](https://bower.io) with [Wiredep](https://www.npmjs.com/package/wiredep) to automate vendor dependencies\ninjecting into the app scripts and styles.\n\nA bunch of [Gulp](https://gulpjs.com) tasks to manage templates, scripts, styles, assets, translations, source maps, and\nto prepare the app for production deployment.\n\n[Browsersync](https://browsersync.io) for live reloading and synchronised testing across browsers and devices.\n\n[Babel](https://babeljs.io) to transpile ES2015 and beyond to vanilla JavaScript.\n\n[ESLint](https://eslint.org) with AngularJS [plugin](https://www.npmjs.com/package/eslint-plugin-angular) to lint your\ncode online and keep it clean.\n\n[Sass](https://sass-lang.com) compiler with [Autoprefixer](https://autoprefixer.github.io) and\n[Normalize.css](https://necolas.github.io/normalize.css).\n\n## Quick start\n\nBoilerplate exists in **Node.js** environment, so you need to install Node.js from\n[official website](https://nodejs.org) or use [NVM](https://github.com/creationix/nvm)\n([NVM for Windows](https://github.com/coreybutler/nvm-windows)) first.   \n\n**Attention! This project still uses Gulp 3 which is [not supported](https://github.com/gulpjs/gulp/issues/2324) by Node\n12.**\n\nAfter setting up Node.js you can use **npm** ([Yarn](https://yarnpkg.com) is an alternative) to install\n[Bower](https://bower.io) and [Gulp](https://gulpjs.com) globally:\n\n```sh\nnpm install -g bower gulp-cli\n```\n\n### Install\n\nClone repository from GitHub:\n\n```sh\ngit clone https://github.com/loginov-rocks/Angular-Gulp-Boilerplate.git MyProject\n```\n\nJump into `MyProject` directory and install dependencies from npm registry:\n\n```sh\ncd MyProject\nnpm install\n```\n\nNext, install dependencies from Bower registry:\n\n```sh\nbower install\n```\n\nAnd that's it!\n\n### Use\n\nExecute Gulp serving task to check if everything is fine:\n\n```sh\ngulp serve\n```\n\nYour default browser will be launched at `http://localhost:3000` serving project. See other Gulp tasks and npm scripts\nyou can use below.\n\n### Global install\n\nAlternatively, you can delegate repository cloning to the package itself. Just install it globally as with Bower and\nGulp:\n\n```sh\nnpm install -g angular-gulp-boilerplate\n```\n\nHaving this package installed globally, you can use the following command to clone the repository into your current\ndirectory:\n\n```sh\nangular-gulp-boilerplate\n```\n\nOr you can specify directory name to clone into as an argument:\n\n```sh\nangular-gulp-boilerplate MyProject\n```\n\nThis command checks out the same version as you have installed globally. So if a new version is released, you can update\npackage with the following command:\n\n```sh\nnpm update -g angular-gulp-boilerplate\n```\n\n## Gulp tasks\n\n### Most used\n\n* `gulp serve` or `npm start` - Build project, start watching for all changes and serve it using Browsersync.\n* `gulp default` or `npm run build` - Clean used directories and build production version ready to deploy.\n\n### Other\n\n* `gulp build` - Build production version ready to deploy.\n* `gulp build-app` - Build production version of app only, without assets.\n* `gulp clean` - Clean distribution and temporary directories.\n* `gulp fonts` - Copy and flatten fonts from Bower packages to distribution dir.\n* `gulp inject` - Inject scripts and styles into HTML entry.\n* `gulp inject:reload` - Start `inject` task and launch Browsersync reloading after.\n* `gulp locales` - Build locales.\n* `gulp locales-angular` - Build Angular locales only.\n* `gulp locales-angular:dist` - Build Angular locales only to distribution dir.\n* `gulp locales:dist` - Build locales to distribution dir.\n* `gulp locales:watch` - Build locales and watch for changes.\n* `gulp other` - Copy various not handled stuff to distribution dir.\n* `gulp partials` - Create template cache from HTML partials.\n* `gulp scripts` - Build scripts.\n* `gulp scripts:clean` - Clean temporary scripts.\n* `gulp scripts:watch` - Build scripts and watch for changes.\n* `gulp serve:dist` or `npm run start:dist` - Build production version and serve it using Browsersync.\n* `gulp styles` - Build styles.\n* `gulp styles:watch` - Build styles and watch for changes.\n* `gulp watch` - Build project and watch for all changes.\n\n## Npm scripts\n\nnpm scripts are not related to the development flow itself, but can be helpful to keep your project up to date.\n\n* `npm run docs:gulp` - Make markdown file containing Gulp tasks description as in the list above.\n* `npm run lint` - Lint JavaScript files.\n* `npm run update:bower` - Update dependencies versions in `bower.json` to the latest.\n* `npm run update:dev` - Update dependencies versions in `package.json` to the latest.\n\nAfter updating dependencies versions you actually need to install them, do it with the following commands:\n\n```sh\nbower install\nnpm install\n```\n\n## Credits\n\nAwesome [generator-gulp-angular](https://github.com/Swiip/generator-gulp-angular) was used as a basis for this project,\nespecially Gulp tasks. This generator is unmaintained for a long time, I refactored it, implemented new features and try\nto keep all dependencies up to date, since it's used in my own production projects.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Floginov-rocks%2Fangular-gulp-boilerplate","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Floginov-rocks%2Fangular-gulp-boilerplate","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Floginov-rocks%2Fangular-gulp-boilerplate/lists"}