CLAUDE.md

geekbing

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 VuePress 2 using the vuepress-theme-reco theme. The site is deployed at https://www.geekbing.topopen in new window and focuses on Python, Go, AI/ML, and independent development topics.

Development Commands

# Start development server
pnpm dev
# or
pnpm start

# Build for production
pnpm build

Project Structure

Core Configuration

.vuepress/config.ts - Main VuePress configuration including theme settings, plugins, navigation, and sidebar (called series in reco theme)

Content Directories

blogs/ - Blog posts organized by category/year (e.g., blogs/ai/2024/0905.md)
- Categories: ai, autotest, docker, go, life, mojo, other, python, rag, saas
docs/ - Static pages and tutorial series with sidebar navigation
- docs/about.md - About page
- docs/django_ninja/ - Django Ninja tutorial series

Theme Customization

.vuepress/components/ - Custom navbar icon components (Home.vue, Document.vue, Github.vue, Timeline.vue, Twitter.vue, User.vue)
.vuepress/public/ - Static assets (logo.png, avatar.png, favicon.ico, head.png)

Build Output

.vuepress/dist/ - Production build output (gitignored)
.vuepress/.cache/ and .vuepress/.temp/ - Build artifacts (gitignored)

Blog Post Frontmatter

Blog posts require YAML frontmatter with at minimum:

---
title: Post Title
date: YYYY-MM-DD
tags:
  - TagName
categories:
  - CategoryName
---

The categories value must match an existing folder under blogs/. Images are referenced from external CDN: https://img.geekbing.top/

Key Configuration Details

Bundler: Vite (@vuepress/bundler-vite)
Theme: vuepress-theme-reco 2.x
Comments: Waline (server: https://waline.geekbing.topopen in new window)
Analytics: Google Analytics (G-YGN1Z8B93J)
SEO: Sitemap and SEO plugins configured for https://www.geekbing.topopen in new window
Sidebar: Configured via series option in theme config (e.g., /docs/django_ninja/ series)