Jekyll Starter Tailwind
A starter kit for using Tailwind with Jekyll that includes:
-
A barebones Jekyll starter theme
-
A Gulpfile that does the following:
- Compiles Tailwind
- Strips out unused CSS using Tailwind's
purge
option - Runs Autoprefixer
- Minifies your CSS
- Compiles Jekyll
- Runs Browsersync for local development
What is Tailwind?
"Tailwind is a utility-first CSS framework for rapidly building custom user interfaces." –Tailwind
What is Jekyll?
"Jekyll is a simple, blog-aware, static site generator perfect for personal, project, or organization sites. Think of it like a file-based CMS, without all the complexity. Jekyll takes your content, renders Markdown and Liquid templates, and spits out a complete, static website ready to be served by Apache, Nginx or another web server. Jekyll is the engine behind GitHub Pages, which you can use to host sites right from your GitHub repositories." –Jekyll
Requirements
Get started
bundle install
to install Ruby gemsnpm ci
to install npm packages listed inpackage-lock.json
npm run start
ornpm run dev
to compile the site with development settings and run BrowserSync
Build your site
npm run build:dev
to compile the site with development settingsnpm run build:production
ornpm run build
to compile the site for production
Deploy
Note: By default, Netlify uses jekyll build
as the build command. The included netlify.toml
file will override it to use npm run build
.
License
How you can help
Enjoying Jekyll Starter Tailwind and want to help? You can:
- Create an issue with some constructive criticism
- Submit a pull request with some improvements to the project
Contributors
Thanks goes to these wonderful people (emoji key):
Roberto Segura |
benmp |
Joey Defourneaux |
Hrvoje Šimić |
Alejandro Figueroa |
This project follows the all-contributors specification. Contributions of any kind welcome!
Can't serve the project
Hey Taylor, I started using your starter kit for a new project I'm doing, but the project failed to start.
I've done some changes to run the kit: Changed
with
I'm not familiar with Gulp, so this might not be the Gulp way of doing things.
Can't build on Windows
Hi Taylor,
Thanks for putting this starter theme together, it's been hugely useful so far!
My issue is similar to issue #64 .
I still get the same error as adrivn with the new update to the script you released, I was able to partially make this work after adding the following packages from npm:
win-node-env win-spawn
Unfortunately I still get an error when trying to run "npm run build" locally on my machine or on Netlify, this is what Netlify returns when trying to deploy:
I can confirm the script is running against the correct directory.
Update gulp spawn to work with latest jekyll and bundle
I was trying to use this and could not get the build process to spawn. I believe its because the jekyll command required the bundler as well. I updated the build command in the gulp file to use the bundler to call jekyll.
Added netlify.toml to override build command
The README correctly specifies that the Netlify build command must be changed, but this can be specified in a netlify.toml file (see docs). This file needs to be ignored by the jekyll build, so the corresponding entry in _config.yml was also created.
Keeps refreshing every 5seconds
After starting the server, withouth making any change in the CSS or elsewhere, it keeps re-loading every 5s automatically, I don't have any control on it.
FYI, I'm using a personal tailwind.config.js file from another project.
Here is my terminal log:
Gulp fixes/improvements
Thanks for this cool starter kit. It helped me a lot.
While trying to use it I found some issues/improvements so here is my contribution:
src
folder was copied to the_site
folder on jekyll build.That caused an issue in my computer because both were trying to use port 4000. In fact we don't really need both because browserSync can trigger the jekyll build and then reload browserSync instance which will result in better performance and an unique server reacting to jekyll/assets changes.
yml
file is changed. It means that if you have data based onyml
files site will get automatically updated with the new data after changing it (to show a menu, etc.).References:
Refactor Gulp tasks into dev & build
Right now, there is only the default task. On save, every single task and optimization is run. I'd like to break out the task into separate dev and build tasks.
The dev task wouldn't minify, run autoprefixer, or remove unused CSS. With the current setup, there's extraneous steps that unnecessarily prolong build time.
Bump postcss-import from 14.0.2 to 15.0.1
Bumps postcss-import from 14.0.2 to 15.0.1.
Changelog
Sourced from postcss-import's changelog.
Commits
2c0c3e9
15.0.12db3239
Correctly sort media queries before joining them (#513)2780457
Preserve layer in ignored import statements (#511)13376a6
Update dependency prettier to ~2.8.0 (#508)22864f1
Update test results for PostCSS 8.4.19 (#507)99d755b
Update dependency ava to v5 (#506)9f6376b
Update dependency eslint-config-problems to v7 (#504)11922cd
Update tests results for postcss v8.4.17 (#503)4e8feca
15.0.0e2ed483
Disable package-lock.jsonDependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting
@dependabot rebase
.Dependabot commands and options
You can trigger Dependabot actions by commenting on this PR:
@dependabot rebase
will rebase this PR@dependabot recreate
will recreate this PR, overwriting any edits that have been made to it@dependabot merge
will merge this PR after your CI passes on it@dependabot squash and merge
will squash and merge this PR after your CI passes on it@dependabot cancel merge
will cancel a previously requested merge and block automerging@dependabot reopen
will reopen this PR if it is closed@dependabot close
will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually@dependabot ignore this major version
will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)@dependabot ignore this minor version
will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)@dependabot ignore this dependency
will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)Bump postcss from 8.3.6 to 8.4.19
Bumps postcss from 8.3.6 to 8.4.19.
Release notes
Sourced from postcss's releases.
... (truncated)
Changelog
Sourced from postcss's changelog.
... (truncated)
Commits
c26baf3
Release 8.4.19 versioned5103d
Update dependencies8086ea3
Merge pull request #1790 from romainmenke/fix-whitespace-bug--passionate-afri...4b38845
fix whitespace bugcf9425a
Merge pull request #1789 from eduardopilati/patch-1ca04e0a
Update plugins.mdfe63768
Update dependencies3b6ba56
Add Node.js 19d33f272
Release 8.4.18 version75d6556
Update dependenciesDependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting
@dependabot rebase
.Dependabot commands and options
You can trigger Dependabot actions by commenting on this PR:
@dependabot rebase
will rebase this PR@dependabot recreate
will recreate this PR, overwriting any edits that have been made to it@dependabot merge
will merge this PR after your CI passes on it@dependabot squash and merge
will squash and merge this PR after your CI passes on it@dependabot cancel merge
will cancel a previously requested merge and block automerging@dependabot reopen
will reopen this PR if it is closed@dependabot close
will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually@dependabot ignore this major version
will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)@dependabot ignore this minor version
will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)@dependabot ignore this dependency
will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)Bump tailwindcss from 2.2.15 to 3.2.3
Bumps tailwindcss from 2.2.15 to 3.2.3.
Release notes
Sourced from tailwindcss's releases.
... (truncated)
Changelog
Sourced from tailwindcss's changelog.
... (truncated)
Commits
757a8d6
update changelog6166e59
3.2.38a2f9ed
Fix !important selectors not being classified as valid class inside safelist ...6bd9912
Only sort pseudo elements after classes when using@apply
and variants (#9765)aac468c
Pick up changes from files that are both context and content deps (#9787)1f5d117
Fix shadowed variable when using raw content (#9773)48c0dca
Update eslint to version 8.26.0763fdde
3.2.2a5b6ec2
update changelog260e392
Update cssnano to version 5.1.14Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting
@dependabot rebase
.Dependabot commands and options
You can trigger Dependabot actions by commenting on this PR:
@dependabot rebase
will rebase this PR@dependabot recreate
will recreate this PR, overwriting any edits that have been made to it@dependabot merge
will merge this PR after your CI passes on it@dependabot squash and merge
will squash and merge this PR after your CI passes on it@dependabot cancel merge
will cancel a previously requested merge and block automerging@dependabot reopen
will reopen this PR if it is closed@dependabot close
will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually@dependabot ignore this major version
will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)@dependabot ignore this minor version
will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)@dependabot ignore this dependency
will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)Bump tailwindcss from 2.2.15 to 3.2.2
Bumps tailwindcss from 2.2.15 to 3.2.2.
Release notes
Sourced from tailwindcss's releases.
... (truncated)
Changelog
Sourced from tailwindcss's changelog.
... (truncated)
Commits
763fdde
3.2.2a5b6ec2
update changelog260e392
Update cssnano to version 5.1.1430d2595
Update autoprefixer to version 10.4.13226be11
update changelogaa979d6
ensure we fallback to''
for backwards compatibility reasonsbf28bf6
Fix cannot read properties of undefined (reading 'modifier') (#9656)0a4ae77
Fix not rebuilding files whenrename
event is emit (#9689)d33b650
Fix incorrect selectors when using@apply
in selectors with combinators and...c10ba4e
Fix fractional values not being parsed properly inside arbitrary properties (...Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting
@dependabot rebase
.Dependabot commands and options
You can trigger Dependabot actions by commenting on this PR:
@dependabot rebase
will rebase this PR@dependabot recreate
will recreate this PR, overwriting any edits that have been made to it@dependabot merge
will merge this PR after your CI passes on it@dependabot squash and merge
will squash and merge this PR after your CI passes on it@dependabot cancel merge
will cancel a previously requested merge and block automerging@dependabot reopen
will reopen this PR if it is closed@dependabot close
will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually@dependabot ignore this major version
will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)@dependabot ignore this minor version
will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)@dependabot ignore this dependency
will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)Bump browser-sync from 2.27.4 to 2.27.11
Bumps browser-sync from 2.27.4 to 2.27.11.
Release notes
Sourced from browser-sync's releases.
Commits
01caeb3
v2.27.1174873cc
updated deps (#1995)88527a8
Add CodeSee architecture diagram workflow to repository (#1972)f6965a6
v2.27.10e6c7bed
Updated portscanner to 2.2.0 (#1960)6a587ec
fix readme's91258ae
Merge branch 'browser-sync-1946-esbuild'f48d6b4
👋 app veyor30c24dc
Merge pull request #19479d24de5
drop webpack from UIDependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting
@dependabot rebase
.Dependabot commands and options
You can trigger Dependabot actions by commenting on this PR:
@dependabot rebase
will rebase this PR@dependabot recreate
will recreate this PR, overwriting any edits that have been made to it@dependabot merge
will merge this PR after your CI passes on it@dependabot squash and merge
will squash and merge this PR after your CI passes on it@dependabot cancel merge
will cancel a previously requested merge and block automerging@dependabot reopen
will reopen this PR if it is closed@dependabot close
will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually@dependabot ignore this major version
will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)@dependabot ignore this minor version
will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)@dependabot ignore this dependency
will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)Bump postcss from 8.3.6 to 8.4.20
Bumps postcss from 8.3.6 to 8.4.20.
Release notes
Sourced from postcss's releases.
... (truncated)
Changelog
Sourced from postcss's changelog.
... (truncated)
Commits
1d4c509
Release 8.4.20 version905082a
Add Node.js 10 to CI20122e5
Fix childless at-rule map generationff7e8ce
Merge pull request #1801 from romainmenke/invalid-sourcemap-with-at-layer--pr...d585976
Fix CI744b15f
Update dependenciesdb935f1
invalid sourcemap with at layer3cac84a
Fix type tests5113edb
Update dependenciesc26baf3
Release 8.4.19 versionDependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting
@dependabot rebase
.Dependabot commands and options
You can trigger Dependabot actions by commenting on this PR:
@dependabot rebase
will rebase this PR@dependabot recreate
will recreate this PR, overwriting any edits that have been made to it@dependabot merge
will merge this PR after your CI passes on it@dependabot squash and merge
will squash and merge this PR after your CI passes on it@dependabot cancel merge
will cancel a previously requested merge and block automerging@dependabot reopen
will reopen this PR if it is closed@dependabot close
will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually@dependabot ignore this major version
will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)@dependabot ignore this minor version
will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)@dependabot ignore this dependency
will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)Bump postcss-import from 14.0.2 to 15.1.0
Bumps postcss-import from 14.0.2 to 15.1.0.
Changelog
Sourced from postcss-import's changelog.
Commits
3f06816
15.1.090e035b
add data url support (#515)2c0c3e9
15.0.12db3239
Correctly sort media queries before joining them (#513)2780457
Preserve layer in ignored import statements (#511)13376a6
Update dependency prettier to ~2.8.0 (#508)22864f1
Update test results for PostCSS 8.4.19 (#507)99d755b
Update dependency ava to v5 (#506)9f6376b
Update dependency eslint-config-problems to v7 (#504)11922cd
Update tests results for postcss v8.4.17 (#503)Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting
@dependabot rebase
.Dependabot commands and options
You can trigger Dependabot actions by commenting on this PR:
@dependabot rebase
will rebase this PR@dependabot recreate
will recreate this PR, overwriting any edits that have been made to it@dependabot merge
will merge this PR after your CI passes on it@dependabot squash and merge
will squash and merge this PR after your CI passes on it@dependabot cancel merge
will cancel a previously requested merge and block automerging@dependabot reopen
will reopen this PR if it is closed@dependabot close
will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually@dependabot ignore this major version
will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)@dependabot ignore this minor version
will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)@dependabot ignore this dependency
will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)Bump decode-uri-component from 0.2.0 to 0.2.2
Bumps decode-uri-component from 0.2.0 to 0.2.2.
Release notes
Sourced from decode-uri-component's releases.
Commits
a0eea46
0.2.2980e0bf
Prevent overwriting previously decoded tokens3c8a373
0.2.176abc93
Switch to GitHub workflows746ca5d
Fix issue where decode throws - fixes #6486d7e2
Update license (#1)a650457
Tidelift tasks66e1c28
Meta tweaksDependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting
@dependabot rebase
.Dependabot commands and options
You can trigger Dependabot actions by commenting on this PR:
@dependabot rebase
will rebase this PR@dependabot recreate
will recreate this PR, overwriting any edits that have been made to it@dependabot merge
will merge this PR after your CI passes on it@dependabot squash and merge
will squash and merge this PR after your CI passes on it@dependabot cancel merge
will cancel a previously requested merge and block automerging@dependabot reopen
will reopen this PR if it is closed@dependabot close
will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually@dependabot ignore this major version
will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)@dependabot ignore this minor version
will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)@dependabot ignore this dependency
will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself) You can disable automated security fix PRs for this repo from the Security Alerts page.Bump engine.io and browser-sync
Bumps engine.io to 6.2.1 and updates ancestor dependency browser-sync. These dependencies need to be updated together.
Updates
engine.io
from 3.5.0 to 6.2.1Release notes
Sourced from engine.io's releases.
... (truncated)
Changelog
Sourced from engine.io's changelog.
... (truncated)
Commits
24b847b
chore(release): 6.2.1425e833
fix: catch errors when destroying invalid upgrades (#658)99adb00
chore(deps): bump xmlhttprequest-ssl and engine.io-client in /examples/latenc...d196f6a
chore(deps): bump minimatch from 3.0.4 to 3.1.2 (#660)7c1270f
chore(deps): bump nanoid from 3.1.25 to 3.3.1 (#659)535a01d
ci: add Node.js 18 in the test matrix1b71a6f
docs: remove "Vanilla JS" highlight from README (#656)917d1d2
refactor: replace deprecatedString.prototype.substr()
(#646)020801a
chore: add changelog for version 3.6.0ed1d6f9
test: make test script work on Windows (#643)Updates
browser-sync
from 2.27.4 to 2.27.10Release notes
Sourced from browser-sync's releases.
Commits
f6965a6
v2.27.10e6c7bed
Updated portscanner to 2.2.0 (#1960)6a587ec
fix readme's91258ae
Merge branch 'browser-sync-1946-esbuild'f48d6b4
👋 app veyor30c24dc
Merge pull request #19479d24de5
drop webpack from UI7a00341
build client with esbuildc30868a
v2.27.99b5fcdc
fix(cli): Where's the command help? fixes #1929 (#1945)Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting
@dependabot rebase
.Dependabot commands and options
You can trigger Dependabot actions by commenting on this PR:
@dependabot rebase
will rebase this PR@dependabot recreate
will recreate this PR, overwriting any edits that have been made to it@dependabot merge
will merge this PR after your CI passes on it@dependabot squash and merge
will squash and merge this PR after your CI passes on it@dependabot cancel merge
will cancel a previously requested merge and block automerging@dependabot reopen
will reopen this PR if it is closed@dependabot close
will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually@dependabot ignore this major version
will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)@dependabot ignore this minor version
will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)@dependabot ignore this dependency
will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself) You can disable automated security fix PRs for this repo from the Security Alerts page.Bump tailwindcss from 2.2.15 to 3.2.4
Bumps tailwindcss from 2.2.15 to 3.2.4.
Release notes
Sourced from tailwindcss's releases.
... (truncated)
Changelog
Sourced from tailwindcss's changelog.
... (truncated)
Commits
f2f1ee9
3.2.413eb1e2
update changelog22d45dd
Update CHANGELOG.md602101d
Allow users to block generation of certain utilities (#9812)4ccc0fa
Make sure errors are always displayed when watching for changes (#9810)1482c75
Fix watching of files on Linux when renames are involved (#9796)757a8d6
update changelog6166e59
3.2.38a2f9ed
Fix !important selectors not being classified as valid class inside safelist ...6bd9912
Only sort pseudo elements after classes when using@apply
and variants (#9765)Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting
@dependabot rebase
.Dependabot commands and options
You can trigger Dependabot actions by commenting on this PR:
@dependabot rebase
will rebase this PR@dependabot recreate
will recreate this PR, overwriting any edits that have been made to it@dependabot merge
will merge this PR after your CI passes on it@dependabot squash and merge
will squash and merge this PR after your CI passes on it@dependabot cancel merge
will cancel a previously requested merge and block automerging@dependabot reopen
will reopen this PR if it is closed@dependabot close
will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually@dependabot ignore this major version
will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)@dependabot ignore this minor version
will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)@dependabot ignore this dependency
will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)