CLAUDE.md

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

Project Overview

This is a modern portfolio website for Leoo Bai, built with Jekyll and deployed on GitHub Pages. The site showcases professional experience, projects, and blog posts with contemporary design elements including gradients, animations, and responsive design.

Development Commands

Local Development

# Install Jekyll and dependencies
bundle install

# Start local development server
bundle exec jekyll serve

# Build the site for production
bundle exec jekyll build

# Clean build artifacts
bundle exec jekyll clean

Alternative Local Development (if Bundler not available)

# Install Jekyll globally
gem install jekyll

# Start development server
jekyll serve

# Build site
jekyll build

Architecture & Structure

Jekyll Configuration

Layout System

Content Organization

When writing, editing, or reviewing a blog post, use the wechat-article skill (.agents/skills/wechat-article/) — it has the style profile, AI-smell checklist, and scan script. See AGENTS.md for the full writing guidelines.

When publishing a finished post to 腾讯云开发者社区 or 微信公众号, use the publish-article skill (.agents/skills/publish-article/) — it covers the Tencent Cloud browser-automation flow and the WeChat content-prep-only flow (mp.weixin.qq.com is blocked from automation by the Claude in Chrome extension itself).

Assets & Styling

Key Features

Styling System

CSS Variables

The site uses CSS custom properties for consistent theming:

Responsive Design

Deployment

The site is configured for GitHub Pages deployment:

Customization Guidelines

Update the navigation.main array in _config.yml:

navigation:
  main:
    - title: "Page Title"
      url: /page-url/

Color Scheme

Edit CSS variables in assets/css/main.css:

:root {
  --primary-color: #009e9f;
  --secondary-color: #007b7c;
  /* ... other variables */
}

Content Updates

Development Notes