CLAUDE.md

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

Project Overview

Personal blog at www.kerrywalker.uk built with Jekyll and the Hydeout theme (v4.2.0), hosted on GitHub Pages.

Common Commands

# Local development server (http://localhost:4000)
bundle exec jekyll serve

# Build site
bundle exec jekyll build

# Lint SCSS
npm run stylelint

Blog Post Format

Posts go in _posts/ with filename format YYYY-MM-DD-title-slug.md:

---
layout: post
title: Post Title Here
excerpt: Brief description for previews and SEO
tags:
  - home-assistant
  - predbat
---

Content in Markdown...

Architecture

• Theme: Hydeout (Jekyll theme) - layouts in _layouts/, partials in _includes/, styles in _sass/hydeout/
• Configuration: _config.yml (site settings, plugins, pagination)
• Custom styling: assets/css/main.scss (green theme color: #90a959)
• Comments: Giscus (GitHub Discussions-based) configured in _includes/comments.html
• Analytics: GA4 in _includes/google-analytics.html (production only)

Git Conventions

• Do not add Co-Authored-By lines to commit messages.

Customization Hooks

The theme provides empty includes for customization without modifying theme files:

• _includes/custom-head.html - Additional head tags
• _includes/custom-foot.html - Footer scripts
• _includes/custom-nav-links.html - Extra sidebar navigation
• _includes/custom-icon-links.html - Extra sidebar icons