Ruby, Middleman & Tailwind Starter Blog template

Live demo: Ruby, Middleman & Tailwind starter blog

A Middleman blog template configured with TailwindCSS, markdown parsing, code highlighting, a sitemap.xml and more. It perfect for lightweight blogging or a personal website. Ruby knowledge is helpful, but not necessary.

Features

• Middleman v4.6,
• Tailwind CSS v4.1,
• Markdown support (via kramdown),
• Blogging support (via middleman-blog),
• Syntax highlighting support (via middleman-syntax),
• Live-reloading (via middleman-livereload) and bin/dev script,
• Automatic sitemap.xml and feed.xml generation,
• SEO-friendly automatic meta tags for title and description,
• Perfect 100/100 PageSpeed score (near perfect for mobile)
• Github Action for image compression (see compress_images.yml).

I've used Middleman for years to build my personal website, and this template consolidates everything I've learned.

Getting started

Before you get started, make sure you've got Ruby installed. Currently, this template uses Ruby v3.2.2 (for compatibility).

Clone this template, then install the required packages and start the server:

# install packages (ruby packages + Tailwind CSS javascript package)
bundle
npm install

# start dev server
bin/dev

Deploying

This template is easy to deploy. Any static site host should work; I've included the Cloudflare, Netlify & Vercel "Deploy" buttons below.

Cloudflare
Netlify
Vercel

Note: These days, I use Cloudflare hosting and I heartily recommend them. I switched from Netlify to Cloudflare a while ago and haven't looked back.