CLAUDE.md

CLAUDE.md

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

What this is

Personal blog and portfolio site for Greg Maslowski (maslowski.cloud), built with Jekyll and hosted on GitHub Pages. Published at https://maslowski.cloud.

Commands

# Serve locally with live reload
bundle exec jekyll serve

# Build only
bundle exec jekyll build

# Install dependencies
bundle install

Local dev server runs at http://localhost:4000. The production URL is https://maslowski.cloud — note that _config.yml has the production URL hardcoded; the commented-out url: http://localhost:4000 line can be swapped for local development if absolute URLs matter.

Ruby is managed via rbenv (Ruby 3.3.0). All Jekyll commands must be prefixed: eval "$(rbenv init -)" && bundle exec jekyll serve.

CI builds are done via Travis CI (bundle exec jekyll build with Ruby 2.3).

Architecture

This is a standard Jekyll site with a two-column layout: a fixed left panel (branding + nav) and a scrollable right panel (content).

Key config (_config.yml): controls site title, social links (Twitter, GitHub, LinkedIn, Stack Overflow), background images per page type, and Jekyll plugins (jekyll-feed, jekyll-sitemap, jekyll-gist).

Layouts (_layouts/): all wrap compress.html (whitespace-stripping layout). The main ones are:

Includes (_includes/): reusable partials — left.html renders the left panel, social-links.html and links.html drive nav, disqus.html handles comments, share.html share buttons.

Pages (_pages/): static pages (about.md, posts.md, tags.md, projects.md, 404.md). Included via include: [_pages] in _config.yml.

Posts (_posts/): Markdown files named YYYY-MM-DD-title.markdown. Only posts with category: blog appear in the post list. Front matter fields used: layout, title, date, description, category, tag (array), comments, image.

Styles (assets/_sass/): SCSS partials compiled from assets/css/main.scss. Variables are in _variables.scss.

Writing a new post

Create _posts/YYYY-MM-DD-slug.markdown with this front matter:

---
layout: post
title: "Post Title"
date: YYYY-MM-DD
description: One-line summary shown in the post list
category: blog
tag:
- tag1
- tag2
comments: true
image: assets/image.png   # optional; shown in left panel for this post
---

Images referenced in posts use https://maslowski.cloud/assets/... for absolute URLs. Images in images/ (not assets/) use a path without a leading slash in front matter: image: images/filename.jpg (the post-list template prepends https://maslowski.cloud/).

Design system

The site uses a Hydejack-inspired layout rebuilt from scratch. Key decisions:

Content notes

Greg writes about EV fleet charging, distributed systems, and software architecture. Domain context:

Build artifacts & generated files

Pre-approved tooling

.claude/settings.local.json already permits, without prompting: bundle exec *, bundle install *, ruby --version, rbenv versions/which *, rvm list *, brew list *, WebSearch, and WebFetch for LinkedIn domains. Prefer these for build/dependency tasks.

Known issues