{"id":24180208,"url":"https://github.com/hholymolly/gulp-template","last_synced_at":"2026-04-27T16:31:37.841Z","repository":{"id":45223609,"uuid":"513430088","full_name":"hHolyMolly/gulp-template","owner":"hHolyMolly","description":"Development starter template based on the Gulp builder","archived":false,"fork":false,"pushed_at":"2025-02-21T20:50:21.000Z","size":27,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-02T19:17:20.264Z","etag":null,"topics":["css","gulp","html","js","js-module","minimization","scss"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hHolyMolly.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-07-13T07:54:18.000Z","updated_at":"2025-02-21T20:50:25.000Z","dependencies_parsed_at":"2025-02-21T21:45:51.840Z","dependency_job_id":"f0256b8c-2d0b-4672-986c-c8d880b506e5","html_url":"https://github.com/hHolyMolly/gulp-template","commit_stats":null,"previous_names":["hholymolly/gulp-template"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hHolyMolly%2Fgulp-template","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hHolyMolly%2Fgulp-template/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hHolyMolly%2Fgulp-template/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hHolyMolly%2Fgulp-template/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hHolyMolly","download_url":"https://codeload.github.com/hHolyMolly/gulp-template/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241557165,"owners_count":19981881,"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":["css","gulp","html","js","js-module","minimization","scss"],"created_at":"2025-01-13T06:12:09.032Z","updated_at":"2026-04-27T16:31:37.829Z","avatar_url":"https://github.com/hHolyMolly.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003ch1\u003eGulp Template\u003c/h1\u003e\n  \u003cp\u003eModern Gulp 4 starter for fast frontend development\u003c/p\u003e\n\n  \u003cp\u003e\n    \u003ca href=\"https://nodejs.org\"\u003e\u003cimg src=\"https://img.shields.io/badge/node-%3E%3D22-brightgreen?style=flat-square\" alt=\"Node.js\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://gulpjs.com\"\u003e\u003cimg src=\"https://img.shields.io/badge/gulp-4-cf4647?style=flat-square\" alt=\"Gulp\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/hHolyMolly/gulp-template/blob/main/LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/badge/license-MIT-blue?style=flat-square\" alt=\"License\"\u003e\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n\u003cbr /\u003e\n\n## Features\n\n- **SCSS** — Dart Sass, autoprefixer, media query merging\n- **HTML Includes** — `@@include` partials with parameters (title, description, image)\n- **SVG Sprites** — automatic symbol sprite generation\n- **Image Optimization** — Sharp (JPG/PNG/WebP/GIF) + auto WebP conversion\n- **BrowserSync** — dev server with hot reload \u0026 404 fallback\n- **Production Build** — HTML/CSS/JS minification, sitemap, robots.txt\n- **Code Quality** — ESLint 9 + Prettier + Stylelint\n- **Tailwind CSS** — optional, one command setup\n\n## Tech Stack\n\n| Category     | Technology                                                                                           |\n| ------------ | ---------------------------------------------------------------------------------------------------- |\n| Task Runner  | [Gulp 4](https://gulpjs.com)                                                                         |\n| Styling      | [Dart Sass](https://sass-lang.com) + [PostCSS](https://postcss.org) (Autoprefixer)                   |\n| Templates    | [gulp-file-include](https://github.com/haoxins/gulp-file-include)                                    |\n| Dev Server   | [BrowserSync](https://browsersync.io)                                                                |\n| Images       | [Sharp](https://sharp.pixelplumbing.com) + auto WebP                                                 |\n| Icons        | [SVG Sprite](https://github.com/svg-sprite/svg-sprite) + [SVGO](https://svgo.dev)                    |\n| Code Quality | [ESLint 9](https://eslint.org) + [Prettier](https://prettier.io) + [Stylelint](https://stylelint.io) |\n\n## Quick Start\n\n```bash\nnpx degit hHolyMolly/gulp-template my-project\ncd my-project\npnpm install\npnpm dev\n```\n\n\u003e **Requirements:** Node.js 22+, pnpm\n\n## Commands\n\n| Command               | Description                             |\n| --------------------- | --------------------------------------- |\n| `pnpm dev`            | Dev server with hot reload              |\n| `pnpm build:dev`      | Development build (no minification)     |\n| `pnpm build:prod`     | Production build (minified + optimized) |\n| `pnpm preview`        | Production build + local preview server |\n| `pnpm lint`           | ESLint + Stylelint with auto-fix        |\n| `pnpm format`         | Prettier formatting                     |\n| `pnpm tailwind:setup` | Add Tailwind CSS to project             |\n| `pnpm clean`          | Remove `dist/`                          |\n| `pnpm clean:cache`    | Clear build \u0026 linter caches             |\n| `pnpm clean:all`      | Remove `node_modules/` and `dist/`      |\n\n## Project Structure\n\n```\nsrc/\n├── html/\n│   ├── layouts/          # Shared partials (_head, _header, _footer, _modals)\n│   ├── pages/            # Each file → dist/*.html\n│   └── components/       # Reusable HTML blocks\n├── styles/\n│   ├── vars.scss         # CSS custom properties\n│   ├── normalize.scss    # CSS reset\n│   ├── fonts.scss        # @font-face declarations\n│   ├── main.scss         # Main styles (auto-imports components/*)\n│   ├── ui.scss           # UI components\n│   ├── utils.scss        # Utility classes\n│   └── critical.scss     # Above-the-fold styles (optional)\n├── scripts/\n│   ├── app.js            # Entry point\n│   ├── components/       # JS components (modals, sliders, spollers, etc.)\n│   └── utils/            # Helpers (DOM, debounce, bodyLock)\n└── assets/\n    ├── fonts/            # Font files\n    ├── img/              # Images (auto WebP + optimization)\n    ├── sprites/          # SVG icons → sprite.symbol.svg\n    └── video/            # Video files\n```\n\n## Configuration\n\nAll settings are in [`project.config.js`](project.config.js):\n\n| Setting        | Description                                     |\n| -------------- | ----------------------------------------------- |\n| `server`       | Port, hostname, auto-open browser               |\n| `optimization` | HTML/CSS/JS/image minification, sitemap, robots |\n| `images`       | WebP/JPEG/PNG quality and compression           |\n| `sprites`      | SVG sprite toggle and filename                  |\n| `sizeReport`   | Gzip build size analysis                        |\n| `postcss`      | Additional PostCSS plugins                      |\n\nEnvironment variables: `.env.development` / `.env.production`.\n\n## Build Pipeline\n\n**Development** — `pnpm dev`\n\n```\nclean → [html, styles, scripts, images, sprites, assets] → watch + BrowserSync\n```\n\nSourcemaps enabled, no minification, file caching for fast rebuilds.\n\n**Production** — `pnpm build:prod`\n\n```\nclean → [html, styles, scripts, images, sprites, assets] → minify → sitemap + robots.txt\n```\n\nHTML/CSS/JS minified, images optimized via Sharp, sourcemaps removed.\n\n## License\n\nMIT © [HolyMolly](https://github.com/hHolyMolly)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhholymolly%2Fgulp-template","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhholymolly%2Fgulp-template","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhholymolly%2Fgulp-template/lists"}