CLAUDE.md

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

Project Overview

Personal blog (“Tales of a Gamer Dad”) at didik.id, built with Jekyll and deployed via Kamal to a self-hosted nginx container.

Dev server: bin/dev (runs bundle exec jekyll serve --livereload --incremental)
Deploy: bin/deploy (runs bundle exec kamal deploy)
Create post/draft: bin/post (interactive Ruby script — creates GitHub issue for comments, generates front matter)
Attach image: bin/attach (resizes image to max 800x600, saves to assets/images/YYYY/MM/DD/, outputs markdown)
Health check: bin/doctor (validates GitHub token and API access for the comments repo)
Build site: bundle exec jekyll build

Jekyll with github-pages gem and remote_theme: devich/quick@0.0.1
Ruby 3.3.10 (managed via mise)
Styling: Pico.css (classless, from CDN) + custom CSS in assets/css/
Deployment: Kamal 2.0 → Docker (nginx serving _site/) → didik.id with SSL. Config in config/deploy.yml
Comments: GitHub Issues-based. Posts have github_comments_issueid in front matter, rendered by _includes/github-comments.html. Comments repo: firewalker06/didik-id-comments
Layouts: default.html (base with OG/Twitter meta, Google Fonts, Pico.css) → post.html (article with schema.org markup + comments)

Posts go in _posts/ as YYYY-MM-DD-slug.md, drafts in _drafts/ as slug.md
Front matter fields: title, slug, date_published, date_updated, description, github_comments_issueid, draft (drafts only)
Images stored in assets/images/YYYY/MM/ (or YYYY/MM/DD/ when using bin/attach)
Blog language is primarily Indonesian
Permalink style: pretty (no .html extensions)

GITHUB_TOKEN required in .env for bin/post and bin/doctor (used to create comment issues via GitHub API)