# CLAUDE.md

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

## Overview

CivilDynamics.org is a Hugo-based static website presenting the Civil Dynamics framework—a structural analysis of political power and its implications for civil society. The site uses the Blowfish theme to present this theoretical framework and its implications for understanding how accessible AI might transform political organization.

## Development Commands

### Development Server
```bash
hugo server
```
Starts the development server with live reload at http://localhost:1313

### Build
```bash
hugo build
```
Builds the static site to the `public/` directory

### Dependencies
- Install hugo (static site generator)
- Install dart-sass (CSS processing)

## Deployment

### Local Docker Build
```bash
hugo build
docker build -t payneio/civildynamics.org . --file ./Dockerfile
docker push payneio/civildynamics.org
```

### Production Deployment
From payne-cloud environment:
```bash
# First time deployment
bin/wild-app-deploy civildynamics

# Updates
kubectl rollout restart deployment civildynamics -n civildynamics
```

## Site Architecture

### Content Structure
- `content/` - All site content in Markdown format
  - `_index.md` - Homepage introducing the Civil Dynamics framework
  - `about/` - Detailed explanation of the framework and its concepts

### Configuration
- `config/_default/` - Hugo configuration split across multiple files
  - `hugo.toml` - Main site configuration (baseURL: https://civildynamics.org/)
  - `params.toml` - Theme-specific parameters
  - `menus.en.toml` - Navigation menu structure
  - `languages.en.toml` - Language settings and site metadata

### Theme
- Uses the Blowfish theme (located in `themes/blowfish/`)
- Theme is included as a git submodule
- Custom CSS can be added in `assets/css/custom.css`

### Static Assets
- `static/` - Static files served directly
- `assets/` - Assets processed by Hugo
- `public/` - Generated output directory (not committed)

## Content Guidelines

### Civil Dynamics Framework
The site focuses on presenting a structural framework for understanding political power:
- The three-vertex pyramid (state, moral, commercial power)
- Purity dynamics and their effect on civil society
- Historical resilience of hierarchical structures
- How accessible AI might enable governance without rule
- The importance of distributed vs. centralized AI architecture

### Page Organization
- Articles use bundle structure with `index.md` and associated images
- Featured images should be named `featured.png` or `featured.jpg`
- Use front matter for metadata (title, description, etc.)

### Hugo Features Used
- Page bundles for content organization
- Taxonomies (tags, categories, authors, series)
- Related content based on tags/categories
- RSS feeds and JSON output
- SEO-optimized with proper meta tags and sitemap generation

## Docker Deployment

The site is containerized using a simple Nginx Alpine image:
- Hugo builds static files to `public/`
- Dockerfile copies `public/` to Nginx document root
- No server-side processing required

## Development Notes

- The site presents a theoretical framework for understanding political power structures
- Content emphasizes structural analysis over ideological positions
- The framework is non-partisan and applies across political systems
- Focus is on how distributed AI might enable new forms of coordination
- No analytics tracking currently configured (googleAnalytics = "")