🚀 Local Development Setup (by Claude Code)

🚀 Local Development Setup (by Claude Code)

Quick Start

./serve.sh

Your site will be available at http://localhost:4000

Local URLs

  • Home: http://localhost:4000
  • About: http://localhost:4000/about.html
  • Publications: http://localhost:4000/publications.html
  • Posts: http://localhost:4000/posts/ (or browse from home)

📝 Note: Add .html extension for pages locally (GitHub Pages uses clean URLs automatically)

How It Works

  • ✅ No Ruby installation needed - Uses Docker
  • ✅ No compilation issues - Bypasses eventmachine problems completely
  • ✅ Looks identical to GitHub Pages - Same content, same styling
  • ✅ Fast and reliable - Builds in ~45 seconds first run, ~15 seconds after
  • ✅ GitHub Pages deployment unchanged - Push to deploy as always

Development Workflow

  1. Edit your posts, pages, or content
  2. Run ./serve.sh to rebuild and serve
  3. View changes at http://localhost:4000
  4. Test pages with .html extension locally
  5. Push to GitHub when ready (clean URLs work automatically)

What’s Fixed

  • ✅ EventMachine compilation issues - Completely solved with Docker
  • ✅ Reliable local development - Simple Python server, no routing complexity
  • ✅ All content works - Pages, posts, images, CSS, JS all load correctly
  • ✅ GitHub deployment unchanged - Clean URLs work on live site

Press Ctrl+C to stop the server