CLAUDE.md

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

Development Commands

Start local development server:

bundle exec jekyll serve --livereload --host local.crawbuck.com --force-polling

Build site:

bundle exec jekyll build

Update post metadata (last modified dates):

ruby update_lastmod.rb

Optimize images:

python scripts/minify.py path/to/image1.png,path/to/image2.png

Architecture Overview

This is a Jekyll static site generator project for a personal portfolio/blog hosted on GitHub Pages at crawbuck.com. The site showcases developer work, projects, and apps.

Key Architectural Decisions:

Jekyll + GitHub Pages: Automatic deployment on push to master branch
Remote Theme: Uses pages-themes/primer@v0.6.0 for consistent GitHub-style design
Custom Styling: CSS files in assets/css/ override theme defaults for home page, posts, and specific sections
Content Structure:
- Work experience posts are prefixed with dates and include “work” tag
- Project posts showcase personal apps and side projects
- Privacy policies, FAQs, and support pages for various apps

Content Management:

Posts in _posts/ use specific naming convention: YYYY-MM-DD-slug.md
Front matter includes: title, date, tags, layout, permalink, redirect_from, og_image, last_modified_at
Work posts typically include company logos, descriptions, and achievements
Project posts feature app icons, screenshots, videos, and App Store links

Asset Organization:

Images: App icons, screenshots, and headers in assets/images/
Videos: Demo recordings in assets/videos/ (multiple formats for compatibility)
Favicons: App-specific favicon sets in assets/favicons/[app-name]/
CSS: Custom styles for different page types (home, posts, resume)

Deployment:

Automatic via GitHub Pages when pushing to master branch
Custom domain configured via CNAME file
No manual build/deploy steps required