{"id":19148091,"url":"https://github.com/lucapipolo/gulp-static-starterkit","last_synced_at":"2026-04-20T03:35:14.603Z","repository":{"id":34241031,"uuid":"170947407","full_name":"LucaPipolo/gulp-static-starterkit","owner":"LucaPipolo","description":"A Gulp task collection for static websites.","archived":false,"fork":false,"pushed_at":"2023-01-06T01:39:47.000Z","size":2147,"stargazers_count":1,"open_issues_count":16,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-10-11T02:36:54.876Z","etag":null,"topics":["gulp","gulp-tasks","npm-package","starter","starter-kit","starter-project"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/LucaPipolo.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.txt","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-02-16T00:53:06.000Z","updated_at":"2020-05-06T17:13:58.000Z","dependencies_parsed_at":"2023-01-15T05:45:29.466Z","dependency_job_id":null,"html_url":"https://github.com/LucaPipolo/gulp-static-starterkit","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LucaPipolo%2Fgulp-static-starterkit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LucaPipolo%2Fgulp-static-starterkit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LucaPipolo%2Fgulp-static-starterkit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LucaPipolo%2Fgulp-static-starterkit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/LucaPipolo","download_url":"https://codeload.github.com/LucaPipolo/gulp-static-starterkit/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240232360,"owners_count":19768981,"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":["gulp","gulp-tasks","npm-package","starter","starter-kit","starter-project"],"created_at":"2024-11-09T07:53:08.851Z","updated_at":"2026-04-20T03:35:14.560Z","avatar_url":"https://github.com/LucaPipolo.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Build Status](https://travis-ci.org/LucaPipolo/gulp-static-starterkit.svg?branch=master)](https://travis-ci.org/LucaPipolo/gulp-static-starterkit)\n\n# Gulp Static StarterKit\n\nThis project born from my daily work needs.\nI wanted something able to cover all the routine operations, like building and injecting assets.\nI've been improving it, until the point I decided it was ready to be published on GitHub.\n\nI hope that this tool helps anybody who is looking for a stable and effective Gulpfile\nto easily build static websites.\n\n## :sparkles: Features\n\n- **Future JS in your hands** — thanks to Babel, you can write beautiful ES6 and ES7 JS since now.\n- **Pug** - Yeah, HTML is not so bad, but Pug rocks! It brings awesome features like functions, imports, variables and many more to your templates.\n- **A lint to rule them all** — You can not do it wrong! Stylelint, ESLint and PugLint are here to help you to code it cleanly.\n- **Built-in HTTP Server** - A built-in server for previewing your site locally is included.\n- **It's so tiny!** - Every single line of HTML, JS and CSS is concatenated and minified. Your pages will load super fast!\n- **Cache ready** - Were we talking about speed, no? Well, this Gulpfile also takes care of adding static revisioning hash to the assets.\n- **GoogleFonts injector** - Just list which Google Fonts you want to use and they're automatically inject. Magic, no?\n- **PageSpeed Insights** - Thanks to Ngrok, you can test your website using Google PageSpeed directly from your local machine.\n\n## :zap: Quickstart\n\n1. First of all, you will need **Node.js**. You can download it from the [offical website](https://nodejs.org/it/) and follow the installation steps for your OS.\n2. Then you'll need **Gulp**. To install it, follow instruction described [here](https://gulpjs.com/).\n3. The last thing to install is **Yarn**, the dependency manager. Follow the steps described on the [website](https://yarnpkg.com/en/docs/getting-started).\n4. Install Gulp Static StarterKit with `yarn add --dev @luca.pipolo/gulp-static-starterkit`.\n5. Create a `gulpfile.js` in the root of your project and require the gulp-static-starterkit package (see [sample.gulpfile.js](https://github.com/LucaPipolo/gulp-static-starterkit/blob/master/sample.gulpfile.js)).\n6. Finally, test if everything works running `gulp`.\n\nGreat, you can now start to use Gulp Static StarterKit! :smile:\n\n## :wrench: Change default configuration\n\nIt's possible to change the default configuration by copying [`config.js`](https://github.com/LucaPipolo/gulp-static-starterkit/blob/master/config.js) file into your project root directory.\n\n## :mag: What's behind the scenes?\n\nAre you curious to know what's happening behind the scenes?\nBelow you can find a detailed list of the defined Gulp tasks. Have fun!\n\n### Style files\n\nSass files are compiled into the `dist/styles` folder.\nCopyright information from `package.json` is injected in the compiled CSS file.\nIf the gulp command is executed with the `--production` option, sourcemaps are not created.\n\n### Script files\n\nES6 and ES7 code is transpiled using Babel into the `dist/scripts` folder.\nCopyright information from `package.json` is injected in the compiled JS file.\nIf the gulp command is executed with the `--production` option, sourcemaps are not created.\n\n### Template files\n\nPug files are compiled into the `dist` folder.\nIf the gulp command is executed with the `--production` option, the images `rev-manifest.json` file is used to replace the images references in the compiled HTML file.\nAlso, `gul-useref` is used to inject CSS and JS files into the compiled HTML file, minifing the assets and adding static asset revisioning hashes.\n\n### Images and Fonts\n\nCustom fonts are flattened and moved into the `dist/fonts` folder. It's possible to automatically install Google Fonts, adding them to a `google-fonts.list` file.\n\nImages are compressed using `gulp-imagemin`. More plugin options are described [here](https://www.npmjs.com/package/gulp-imagemin#custom-plugin-options).\nIf the gulp command is executed with the `--production` option, the `rev-manifest.json` is created to store the hashed images references.\n\n### Google Page Speed\n\nUses ngrok + PSI to locally test Google Page Speed performances.\nRun it with `gulp performance`.\n\n## :computer: Contribute\n\nAny kind of contribution is welcome!\nIf you notice something wrong please open an issue [here](https://github.com/LucaPipolo/gulp-static-starterkit/issues) and create a Pull Request.\nBe sure to read our [code of conduct](https://github.com/LucaPipolo/gulp-static-starterkit/blob/master/CODE_OF_CONDUCT) before starting to code.\n\n## :pencil2: License\n\n[GPL-3.0 License](https://www.gnu.org/licenses/gpl-3.0.en.html) © [Luca Pipolo](https://www.lucapipolo.com)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flucapipolo%2Fgulp-static-starterkit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flucapipolo%2Fgulp-static-starterkit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flucapipolo%2Fgulp-static-starterkit/lists"}