CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Commands

bundle install              # Install Ruby dependencies
bundle exec jekyll serve    # Local dev server (http://localhost:4000)
bundle exec jekyll build    # Production build to _site/
bundle exec jekyll serve --drafts  # Include _drafts/ in local server

No test suite or linter is configured.

Architecture

This is a Jekyll 4 static site deployed to GitHub Pages at yourwebdevguy.com.

Theme: Minima with custom overrides. Override files live in _layouts/, _includes/, and _sass/minima/ — these take precedence over the gem’s defaults.

Collections (beyond standard _posts/):

  • _dev_notes/ — how-to guides, served at /how-to/:path/
  • _musings/ — personal reflections, served at /musings/:path/
  • _slides/ — presentation slides
  • _drafts/ — unpublished posts (not built in production)

Key config (_config.yml):

  • Plugins: jekyll-feed, jekyll-paginate, jekyll-seo-tag
  • Pagination: configured via jekyll-paginate

Styling: SCSS in _sass/minima/. The entry point is assets/css/ which imports from _sass/.

Assets: Static files in assets/ (images, vendor JS/CSS). No Node.js build pipeline — vendor libraries are committed directly.