CLAUDE.md

CLAUDE.md

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

Project Overview

This is the Kittysplit blog (blog.kittysplit.com), a Jekyll 4.4 static site hosted on GitHub Pages. Deploying is done by pushing to the main branch.

Commands

  • Install dependencies: bundle
  • Run locally: bundle exec jekyll serve --port 3000
  • Run with drafts: bundle exec jekyll serve --drafts --port 3000

Architecture

  • _posts/ — Published blog posts (Markdown with YAML front matter)
  • _drafts/ — Unpublished draft posts
  • _layouts/ — default.html (base), post.html, page.html
  • _includes/ — Reusable partials (analytics, social icons, twitter plug)
  • style.css / highlighting-style.css — Site styles (Sass compiled by Jekyll)
  • images/ — Post images, organized by date subdirectories (e.g., images/2026-02-11/)

Blog Post Conventions

  • Posts use the naming format YYYY-MM-DD-slug.md
  • Front matter requires layout: post and title; image is optional (used for social cards)
  • Use <!-- read-more --> to mark excerpt boundaries (configured as excerpt_separator in _config.yml)
  • Permalinks follow the /:title/ pattern
  • Date format in posts is dd.mm.YYYY
  • Images are referenced with kramdown attributes for sizing: {: width="320"}

Plugins

  • jekyll-sitemap — Auto-generates sitemap.xml
  • jekyll-seo-tag — SEO meta tags and social cards