{"id":21178941,"url":"https://github.com/joseffie/gulp-joseffie-tailwind-pack","last_synced_at":"2026-04-07T23:31:57.093Z","repository":{"id":116040069,"uuid":"528583743","full_name":"joseffie/gulp-joseffie-tailwind-pack","owner":"joseffie","description":"Front-end boilerplate and framework based on Gulp, Pug, SCSS, Tailwind and Babel.","archived":false,"fork":false,"pushed_at":"2022-09-01T17:12:07.000Z","size":260,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-14T18:49:13.566Z","etag":null,"topics":["automatization","babel","bem","bem-tools","development-environment","development-tools","development-workflow","eslint","gulp","lint-staged","postcss","pug","scss","starterkit","stylelint","tailwind","webpack"],"latest_commit_sha":null,"homepage":"","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/joseffie.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":"2022-08-24T20:27:21.000Z","updated_at":"2022-09-09T18:11:59.000Z","dependencies_parsed_at":"2023-03-17T18:30:53.904Z","dependency_job_id":null,"html_url":"https://github.com/joseffie/gulp-joseffie-tailwind-pack","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/joseffie/gulp-joseffie-tailwind-pack","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joseffie%2Fgulp-joseffie-tailwind-pack","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joseffie%2Fgulp-joseffie-tailwind-pack/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joseffie%2Fgulp-joseffie-tailwind-pack/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joseffie%2Fgulp-joseffie-tailwind-pack/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/joseffie","download_url":"https://codeload.github.com/joseffie/gulp-joseffie-tailwind-pack/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joseffie%2Fgulp-joseffie-tailwind-pack/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31533823,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-07T16:28:08.000Z","status":"ssl_error","status_checked_at":"2026-04-07T16:28:06.951Z","response_time":105,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["automatization","babel","bem","bem-tools","development-environment","development-tools","development-workflow","eslint","gulp","lint-staged","postcss","pug","scss","starterkit","stylelint","tailwind","webpack"],"created_at":"2024-11-20T17:27:24.192Z","updated_at":"2026-04-07T23:31:57.075Z","avatar_url":"https://github.com/joseffie.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# gulp-joseffie-tailwind-pack\n\n\u003e Gulp based starter template for better front-end coding with TailwindCSS and Pug \u0026 SCSS preprocessors\n\n## Table of contents\n\n- [gulp-joseffie-tailwind-pack](#gulp-joseffie-tailwind-pack)\n  - [Table of contents](#table-of-contents)\n  - [Features](#features)\n  - [Quickstart](#quickstart)\n  - [Main tasks](#main-tasks)\n  - [Troubles using Pug with Tailwind](#troubles-using-pug-with-tailwind)\n  - [Component generator](#component-generator)\n  - [Copyright](#copyright)\n\n## Features\n\n- Component approach with [BEM](https://en.bem.info/) based.\n- Automatic creation of component directories with files using the [bem-tools-create](https://github.com/bem-tools/bem-tools-create) tool.\n- Automatic transform of fonts to woff/woff2 and file creation with `@font-face` declarations.\n- Optimization and conversion of images to webp format.\n- Automatic icon system based on SVG sprites.\n- Checking for and fixing errors on commit.\n- Using a hard code guide.\n\n## Quickstart\n\nMake sure you have [NodeJS](https://nodejs.org/en/) and [Yarn](https://yarnpkg.com/) installed\n\n1. Install the [Gulp](https://gulpjs.com/) and [bem-tools-core](https://github.com/bem-tools/bem-tools-create) globally:\n\n```\n$ yarn add --globall gulp bem-tools-core bem-tools-create\n```\n\n2. Clone the project using:\n\n```\n$ git clone https://github.com/joseffie/gulp-joseffie-tailwind-pack.git my-project\n```\n\n3. Go to the project and run:\n\n```\n$ yarn\n```\n\n4. After installing the dependencies, start the dev server:\n\n```\n$ yarn run dev\n```\n\n## Main tasks\n\n- `yarn run dev` - launches watcher and server.\n- `yarn run build` - compiles and optimises project.\n- `yarn run zip` - build and archives project.\n- `yarn run deploy` - builds project and pushes to GitHub repo in `gh-pages` branch.\n- `yarn run build:fonts` - compiles an local fonts located in `src/assets/fonts`.\n- `yarn run build:sprites` - compiles an SVG icons located in `src/assets/icons` into SVG sprites.\n\n## Troubles using Pug with Tailwind\n\nSome characters used in Tailwind classes are not supported by Pug when writing classes with a dot `.`:\n\n- The colon character `:` used for [utilities to style elements](https://tailwindcss.com/docs/hover-focus-and-other-states). This problem was fixed by changing the separator in `tailwind.config.cjs` from colon `:` to underscore `_`.\n\n```pug\n//- not supported, the code will return an error\nelement.font-gray-900.hover:font-blue-500\n\n//- write\nelement.font-gray-900.hover_font-blue-500\n```\n\n- The `[` and `]` characters used to write [arbitrary values](https://tailwindcss.com/docs/adding-custom-styles#using-arbitrary-values). You will have to write classes for arbitrary values in the `class` attribute.\n\n```pug\n//- not supported, the code will return an error\nelement.max-w-lg.mx-auto.px-[25px]\n\n//- write\nelement.max-w-lg.mx-auto(class='px-[25px]')\n```\n\n- Likewise with the `/` character, which is used in fractional values, and with `!` character which is used for important defining.\n\n```pug\n//- not supported, the code will return an error\nelement.w-1/2\nelement.!text-blue-100\n\n//- write\nelement(class='w-1/2')\nelement(class='!text-blue-100')\n```\n\n## Component Generator\n\nCreate empty component by name in `src/components` folder.\n\nBy default generates only `*.pug`, `*.scss` and `*.js` files.\n\n```\n$ bem create component-name\n```\n\nIf you need to create only one file type, use the `-T` flag:\n\n```\n$ bem create component-name -T pug\n```\n\nIf you need to remove one or more default file types, use the `-n` flag:\n\n```\n$ bem create component-name -n js\n```\n\nIf you need to add another file type to your component folder, use the `-t` flag:\n\n```\n$ bem create component-name -t md\n```\n\nYou can also combine flags:\n\n```\n$ bem create component-name -n js -t yml\n```\n\n## Copyright\n\n_Ivan Gavrilich (joseffie) © 2022 - today [The MIT License](./LICENSE)_\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoseffie%2Fgulp-joseffie-tailwind-pack","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjoseffie%2Fgulp-joseffie-tailwind-pack","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoseffie%2Fgulp-joseffie-tailwind-pack/lists"}