Skip to content

Commit 4ef19b5

Browse files
johanrinclaude
andcommitted
Add CLAUDE.md for Claude Code guidance
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1 parent a1efc49 commit 4ef19b5

1 file changed

Lines changed: 64 additions & 0 deletions

File tree

CLAUDE.md

Lines changed: 64 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,64 @@
1+
# CLAUDE.md
2+
3+
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
4+
5+
## Project Overview
6+
7+
This is a Hugo static blog site deployed to GitHub Pages. The site focuses on AI, cloud architecture, and Microsoft Foundry content.
8+
9+
**Tech Stack:** Hugo (v0.153.2) with hugo-blog-awesome theme (Git submodule)
10+
11+
## Common Commands
12+
13+
```bash
14+
# Local development
15+
hugo server # Start dev server with live reload
16+
17+
# Production build
18+
hugo --gc --minify # Build with garbage collection and minification
19+
20+
# Create new blog post
21+
hugo new posts/my-post/index.md # Creates post from archetypes/default.md template
22+
```
23+
24+
## Architecture
25+
26+
```
27+
content/en/
28+
├── posts/ # Blog posts (each post is a directory with index.md + images)
29+
├── pages/ # Static pages (about.md)
30+
└── _index.md # Homepage
31+
32+
layouts/ # Custom overrides for theme templates
33+
├── _default/_markup/render-image.html # Image zoom effect
34+
├── partials/bio.html # Author bio
35+
├── partials/custom-head.html # OG/Twitter meta tags
36+
└── robots.txt # SEO configuration
37+
38+
themes/hugo-blog-awesome/ # Theme submodule (do not edit directly)
39+
```
40+
41+
## Content Structure
42+
43+
Blog posts use directory-based organization:
44+
```
45+
content/en/posts/my-post/
46+
├── index.md # Post content with YAML front matter
47+
├── cover.png # Featured image
48+
└── *.png # Additional images
49+
```
50+
51+
**Front matter fields:** title, date, image, description, categories, tags, draft
52+
53+
## Configuration
54+
55+
Main configuration is in `hugo.toml`:
56+
- Language: English (en-us)
57+
- Theme: hugo-blog-awesome
58+
- Dark mode by default
59+
- Google Analytics enabled
60+
- Table of Contents: H2-H4 levels
61+
62+
## Deployment
63+
64+
GitHub Actions workflow (`.github/workflows/hugo.yaml`) automatically builds and deploys to GitHub Pages on push to `main` branch.

0 commit comments

Comments
 (0)