jekyll-fun

In kind of a spin-off of fun, this is a Jekyll starter kit that can be used to quickly build out a production-ready Jekyll static site.

Features

• Webpack for managing all of the assets
• Tailwind baked in for utility-first CSS
• Stimulus as a lightweight javascript framework
• PostCSS used to load Tailwind and make postcss-import and postcss-preset-env available to use
• BrowserSync for live reloading of browser after code changes
• jekyll-seo-tag for generating SEO tags
• jekyll-sitemap for generating a sitemap

Setup

1. bundle install
2. yarn install

Directory Structure

_src

All of the CSS, JS and images are stored in the _src directory, which is managed by Webpack.

Usage

1. rake serve
2. yarn dev

Alternatively, if you have [foreman] installed, you can foreman start and both the web and webpack instances will be started.

The Process

When Webpack runs, it compiles all of the assets into the /assets directory and then generates the base layout to _layouts/base.html with the appropriate <link> and <script> tags injected into it.