CLAUDE.md

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

Build Commands

# Install dependencies (first time setup)
bundle install

# Run local development server (serves at http://localhost:4000)
bundle exec jekyll serve

# Build site for production (output to _site/)
bundle exec jekyll build

Architecture

This is a Jekyll-based personal website hosted on GitHub Pages at jeremybernste.in.

Key Directories

• _layouts/ - HTML templates (default.html for pages, post.html for blog posts)
• _data/papers.yml - Structured data for research papers
• writing/_posts/ - Blog posts in Markdown with Jekyll front matter
• research/ - Research paper pages (each paper has its own subdirectory)
• css/screen.css - Main stylesheet with section-specific color schemes
• js/fall.js - 3D falling polyhedra canvas animation (currently disabled for performance)

Page Front Matter

Pages use this front matter pattern:

---
layout: default
title: Page Title
alt_title: Navigation Label  # shown in nav menu
order: 1                     # menu ordering
---

Content Sections

Each main section has a distinct background color defined in css/screen.css:

• Home: light blue (#90ecfc)
• Writing: light green (#c3fcb3)
• Research: light orange (#ffe6a1)
• Teaching: light purple (#f3bbfc)

Technologies

• Jekyll with GitHub Pages plugins (jekyll-sitemap, jekyll-feed)
• MathJax 3 for LaTeX math rendering in posts
• Vanilla JavaScript (no frameworks)
• CSS Grid for layout

License

• _posts/ and _shortest_path/ content is Copyright Jeremy Bernstein
• All other code is MIT Licensed