Files

Eric Wagoner 2083d5931b Add Claude Code configuration files

- Add CLAUDE.md with project documentation for Claude Code
- Add .claude/settings.local.json with local settings
- These files help Claude Code understand the blog structure and provide better assistance

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

2025-09-22 19:34:03 -04:00

2.3 KiB

Raw Permalink Blame History

CLAUDE.md

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

Project Overview

This is a personal blog built with Hugo static site generator. The site is deployed to https://blog.kestrelsnest.social and uses the "m10c" theme.

Common Commands

Development

# Start development server with drafts visible
hugo server -D

# Start development server without drafts
hugo server

# Kill existing Hugo server if port is in use
pkill -f "hugo server"

Building

# Build the site to public/ directory
hugo

# Build with drafts included
hugo -D

Deployment

# Deploy to production (builds and syncs to server)
./deploy

The deploy script builds the site and uses rsync to sync the public/ directory to the production server at social:../../var/www/blog/www. It uses the --delete flag to remove files on the server that aren't in the local public folder.

Content Management

# Create a new blog post
hugo new posts/my-new-post.md

# Create content using the default archetype
hugo new content-name.md

Architecture & Structure

Theme System

The blog uses the "m10c" theme but has two additional themes available (henry, kestrel). Theme switching is done via config.toml.

Content Organization

/content/posts/ - Blog posts
/content/now.md - "Now" page showing current activities
/content/then.md - "Past" page with historical content
/content/upcoming.md - "Future" page with upcoming events
/content/mytweets.md - Local tweet archive page

The site has four menu groups configured in config.toml:

main: Home and Tags navigation
secondary: Past, Now, Future pages
tertiary: Local Tweet Archive
featured: External links like the Random Recipe Project

Key Configuration

Base URL: https://blog.kestrelsnest.social
Author: Eric Wagoner
Social links are configured in config.toml under params.social
Default Open Graph image: /static/default-og.png

Important Notes

The Hugo server automatically watches for changes in /archetypes, /assets, /content, /data, /layouts, /static, and /themes
Posts are created with draft status by default (controlled by archetype)
The site integrates with multiple social platforms and services in the Kestrel's Nest ecosystem

2.3 KiB Raw Permalink Blame History