bhargavachary.github.io — Claude Context

bhargavachary.github.io — Claude Context

Personal website and blog — https://bhargavachary.in Jekyll site using bulma-clean-theme (GitHub Pages compatible).

Stack

  • Jekyll + GitHub Pages (Ruby — no conda/Python env needed)
  • Theme: chrisrhymes/bulma-clean-theme@v0.14.0 (remote theme via remote_theme in _config.yml)
  • Analytics: Google Analytics G-TFVWELSZ9W
  • Comments: Disqus (bhargavacharyin)
  • Deploy: GitHub Actions → .github/workflows/jekyll.yml (triggers on push to master)

Structure

_posts/         ← blog posts (YYYY-MM-DD-title.md)
_pages/         ← static pages
_data/          ← YAML data files (nav, authors, etc.)
_includes/      ← reusable HTML partials
_layouts/       ← page layout templates
_config.yml     ← site config (do not change url or baseurl)
Gemfile         ← Ruby deps (github-pages gem + plugins)
scripts/
  optimize-images.sh   ← image optimization (run before committing images)

Key Rules

  • Posts: _posts/YYYY-MM-DD-title.md with front matter (layout, title, date, categories)
  • Do not change url: "https://bhargavachary.in" or baseurl: "" in _config.yml
  • Do not modify the remote theme version without testing locally first
  • Optimize images before committing: bash scripts/optimize-images.sh
  • Do not commit a macOS-generated Gemfile.lock — it’s platform-specific and will break CI
  • Public repo — never commit credentials, tokens, or new tracking IDs

Local Dev

bundle install
bundle exec jekyll serve
# open http://localhost:4000

Deploy

Push to master → GitHub Actions builds and deploys automatically. Do not manually push to gh-pages — CI owns that branch.