Skip to content

CLAUDE.md

Latest commit

 

History

History
80 lines (54 loc) · 2.22 KB

CLAUDE.md

File metadata and controls

80 lines (54 loc) · 2.22 KB

CLAUDE.md

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

What This Is

Documentation site for RawCull, a native macOS app for culling Sony ARW RAW files. Built with Hugo using the Docsy theme as a Hugo module.

Commands

# Install dependencies (first time)
npm install

# Local development server (live reload)
npm run serve

# Production build
npm run build:production

# Preview build (used by Netlify for PRs)
npm run build:preview

# Clean build artifacts
npm run clean

# Update Hugo to latest
npm run update:hugo

# Update npm packages
npm run update:pkgs

Docker alternative:

docker-compose up
# Available at http://localhost:1313

Content Structure

All content lives in content/en/:

  • docs/ — Main documentation pages (culling, sharpness, focus peaking, focus points, settings, security)
  • blog/releases/ — Changelog entries, one file per version (e.g. version-1.3.4.md)
  • blog/technical/ — Technical posts

Adding a release

Create content/en/blog/releases/version-X.Y.Z.md using TOML front matter:

+++
author = "Thomas Evensen"
title = "Version X.Y.Z"
date = "YYYY-MM-DD"
tags = ["changelog","version X.Y.Z"]
categories = ["changelog"]
+++

Hugo Configuration

  • hugo.yaml — Main site config (Docsy theme, languages, params, module imports)
  • hugo-disabled.toml — Disabled/reference config (not active)
  • go.mod / go.sum — Hugo module dependencies (Docsy, Font Awesome, Bootstrap)
  • docsy.work — Hugo workspace file for local Docsy development

The Docsy theme is pulled as a Hugo module (not a git submodule). Hugo Extended is required (extended: true in hugo.yaml). Minimum Hugo version: 0.135.0.

Layouts

Custom layout overrides live in layouts/ and take precedence over the Docsy theme defaults. The layouts/partials/ directory contains any partial overrides.

Spell Checking

The project uses cSpell (.cspell.yml). When adding new technical terms, acronyms, or proper nouns, add them to the # cSpell:ignore comment at the top of hugo.yaml.