Jekyll Run Plugin: Fixing the Multi-Root Workspace Crash
The Jekyll Run VS Code extension crashes with 'TypeError: Cannot read properties of null' in multi-root workspaces on macOS. The error is misleading — the real problem is macOS GUI apps don't inherit your shell PATH, so the plugin runs system Ruby 2.6. The fix is rbenv with Ruby 3.3, launching VS Code from a terminal, and understanding why every other approach fails.
Building a Custom Tag and Category Generator Plugin for Jekyll
GitHub Pages doesn't support tag or category pages out of the box. Here's how I built a custom Jekyll generator plugin that creates them automatically — and the SEO lessons learned along the way.
Upgrading Jekyll: Two Years of Cascading Breakage
Every Jekyll upgrade broke something downstream. Ruby 3.0 dropped webrick. Jekyll 4.3 broke SASS imports. Dart Sass 3.0 deprecated color functions. Node.js 24 forced all GitHub Actions to update. Here's the full upgrade timeline and what each one taught me.
Your Jekyll Sitemap Is 60% Garbage
I audited my Jekyll sitemap and found that 262 of 434 URLs were auto-generated tag pages, category pages, and pagination — most with a single post. Here's how to clean it up without losing anything.
Running Github Pages locally
Getting Jekyll and GitHub Pages running locally in WSL2 Ubuntu, including the missing webrick fix for Ruby 3.0+ and using VS Code for markdown editing.