CLAUDE.md

CLAUDE.md

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

Commands

# Development (most common)
npm run serve              # Local dev server
./start.sh                 # Quick wrapper for Jekyll serve

# Build
npm run build              # Production build

# Development variants
npm run dev                # Dev with custom config
npm run demo-dev           # Demo environment

Architecture

Jekyll static site generator with TeXt theme v2.0.2. Simple blog architecture focused on content and engineering deep-dives.

Core Structure

_posts/                    # Blog posts (markdown + YAML frontmatter)
_layouts/                  # Page templates
_includes/                 # Reusable components  
_sass/                     # SCSS styling system
_data/                     # Site configuration data
assets/                    # Static assets (images, CSS)
archived/                  # Legacy content

Technical Details

  • Markdown processor: Kramdown
  • Syntax highlighting: Rouge
  • Deployment: GitHub Pages → https://www.datsama.com
  • Timezone: Asia/Ho_Chi_Minh
  • Pagination: 3 posts/page
  • Excerpt separator: <!--more-->

Content Style

Blog reflects humble, engineering-focused approach:

  • Technical deep-dives (see kotlin-coroutines-deep-dive.md:38-95)
  • Concise, practical content
  • Charlie Brown references for humility
  • TBD placeholders for iterative development

Dependencies

  • Ruby gems via Bundler (Gemfile)
  • Jekyll plugins: feed, paginate, sitemap, jemoji
  • Development server binds to 0.0.0.0 for container compatibility

© Dat Nguyen 2018 RSS