# 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
```bash
# 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
```bash
# Build the site to public/ directory
hugo

# Build with drafts included
hugo -D
```

### Deployment
```bash
# 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
```bash
# 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

### Menu Structure
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