{"id":13477843,"url":"https://github.com/jasewarner/gulp-shopify","last_synced_at":"2025-04-09T09:06:58.952Z","repository":{"id":39406545,"uuid":"77216415","full_name":"jasewarner/gulp-shopify","owner":"jasewarner","description":"Blank slate Shopify theme for Developers, packaged with Gulp.js for processing SCSS, JavaScript (ES6), images and fonts. Made to support Online Store 2.0 features and Shopify CLI.","archived":false,"fork":false,"pushed_at":"2024-06-11T09:24:49.000Z","size":598,"stargazers_count":183,"open_issues_count":0,"forks_count":78,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-02T06:08:31.076Z","etag":null,"topics":["es6","gulp","online-store-2point0","sass","scss","shopify","shopify-cli","shopify-cli-theme","shopify-skeleton-theme","shopify-theme","shopify-themes","theme"],"latest_commit_sha":null,"homepage":"https://jase.io/gulp-shopify","language":"Liquid","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/jasewarner.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-12-23T09:56:11.000Z","updated_at":"2025-03-19T07:39:15.000Z","dependencies_parsed_at":"2023-02-18T19:01:30.194Z","dependency_job_id":"ccf91d08-0e86-4f2c-ba5e-94fdbc60eefa","html_url":"https://github.com/jasewarner/gulp-shopify","commit_stats":null,"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jasewarner%2Fgulp-shopify","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jasewarner%2Fgulp-shopify/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jasewarner%2Fgulp-shopify/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jasewarner%2Fgulp-shopify/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jasewarner","download_url":"https://codeload.github.com/jasewarner/gulp-shopify/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248008630,"owners_count":21032556,"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":["es6","gulp","online-store-2point0","sass","scss","shopify","shopify-cli","shopify-cli-theme","shopify-skeleton-theme","shopify-theme","shopify-themes","theme"],"created_at":"2024-07-31T16:01:48.380Z","updated_at":"2025-04-09T09:06:58.930Z","avatar_url":"https://github.com/jasewarner.png","language":"Liquid","funding_links":["https://www.buymeacoffee.com/jasewarner/"],"categories":["Liquid"],"sub_categories":[],"readme":"# Gulp + Shopify\n\nVersion: 2.0.3\n\n## Author\n\nJase Warner ( [https://jase.io](https://jase.io \"Jase Warner’s website\") )\n\n\u003e If this project has been a helping hand to you, feel free to [give this grateful developer a coffee](https://www.buymeacoffee.com/jasewarner/) ☕️\n\n## Synopsis\n\n**Update:** 2021/09/15 – This project has been updated to support Shopify CLI and [Online Store 2.0](https://www.shopify.com/partners/blog/shopify-online-store \"Online Store 2.0 article\") features.\n\n*Gulp + Shopify* is for Developers wishing to use [Gulp.js](http://gulpjs.com/ \"Gulp.js website\") in combination with [Shopify CLI](https://shopify.dev/themes/tools/cli \"Shopify CLI page\") to develop Shopify themes \u0026ndash; a tidy solution to the problem with Shopify not allowing sub-directories within the `assets` directory.\n\nThe theme is packaged with Gulp for watching and compiling assets in the `dev` directory, including SCSS, JS, images, and fonts. When modified, said assets are moved across to the `assets` directory.\n\nA selection of helpful mixins is also included, most of which are featured in [this useful article](http://zerosixthree.se/8-sass-mixins-you-must-have-in-your-toolbox/ \"Mixins article\") by [@seb_ekstrom](https://twitter.com/seb_ekstrom \"@seb_ekstrom on Twitter\").\n\nYou may also write your JavaScript in ES6 \u0026ndash; The Gulp scripts task uses [Babel](https://babeljs.io/ \"Babel website\"), so you can use the latest syntax without worrying about browser support.\n\nThe theme Liquid and JSON files are all blank canvases – zero faffing, meaning you can crack on with the build right away.\n\nThe theme includes the Bootstrap 5 grid and reboot scss files. These can be removed in `theme.scss.liquid` and `password.scss.liquid`, or, if you so wish, you may add more Bootstrap SCSS files using @import via `./node_modules/bootstrap/scss/`.\n\n## Installation\n\n### Gulp.js\n\nClone the repo into your project root.\n\nIn Terminal `cd` into the `dev` directory and install the Gulp packages (if you haven’t already installed Gulp, you’ll need to [do so](https://github.com/gulpjs/gulp/blob/master/docs/getting-started.md \"Gulp installation\") first):\n\n`npm install`\n\nOnce you have installed the packages, in Terminal, run `gulp` and then `gulp watch`.\n\nAny changes to the SCSS files in `dev/sass/` will be reflected in `theme.css.liquid` and/or `password.css.liquid` in `assets`.\n\nAny alterations to the JS files in `dev/js/` will be concatenated and uglified in `assets` to `theme.js`.\n\nImages added to `dev/image` will be copied across to the `assets` directory. Similarly, any fonts added to `dev/font` will be copied across to `assets`.\n\n### Shopify CLI\n\nTo get Shopify CLI up and running, follow the instructions [here](https://shopify.dev/themes/tools/cli/installation \"Shopify CLI installation instructions\").\n\nTo get started on your theme, follow [these instructions](https://shopify.dev/themes/tools/cli/getting-started \"Shopify CLI usage instructions\").\n\n\u003e Important: Unfortunately the Shopify CLI hot reload feature fires too soon for Shopify to serve any updated assets, such as CSS or JS. I’ve only been working with Shopify CLI for a couple of weeks now, so maybe I’ve missed something, but I’m finding that a manual reload (delayed by a second or two) is still required after every change.\n\n## Features\n\nThe Gulp build features the following helpful packages:\n\n* [gulp-autoprefixer](https://github.com/sindresorhus/gulp-autoprefixer \"gulp-autoprefixer GitHub page\")\n* [gulp-babel](https://github.com/babel/gulp-babel \"gulp-babel GitHub page\")\n* [gulp-concat](https://github.com/contra/gulp-concat \"gulp-concat GitHub page\")\n* [gulp-rename](https://github.com/hparra/gulp-rename \"gulp-rename GitHub page\")\n* [gulp-replace](https://github.com/lazd/gulp-replace \"gulp-replace GitHub page\")\n* [gulp-sass](https://github.com/dlmanning/gulp-sass \"gulp-sass GitHub page\")\n* [gulp-uglify](https://github.com/terinjokes/gulp-uglify \"gulp-uglify GitHub page\")\n* [gulp-scss-lint](https://github.com/juanfran/gulp-scss-lint \"gulp-scss-lint GitHub page\")\n\n## Credits\n\n* [Gulp.js](http://gulpjs.com/ \"Gulp.js website\")\n* [Shopify CLI](https://shopify.dev/themes/tools/cli \"Shopify CLI page\")\n* [SASS / SCSS](http://sass-lang.com/ \"SASS website\")\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjasewarner%2Fgulp-shopify","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjasewarner%2Fgulp-shopify","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjasewarner%2Fgulp-shopify/lists"}