daveworth · daveworth · Jan 20, 2026 · Jan 20, 2026 · Jan 20, 2026 · Jan 20, 2026
diff --git a/.github/workflows/deploy.yml b/.github/workflows/deploy.yml
@@ -0,0 +1,34 @@
+name: Deploy to GitHub Pages
+
+on:
+  push:
+    # TODO: remove feat/astro-migration after migration complete
+    branches: [master, feat/astro-migration]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: volta-cli/action@v4
+      - run: npm ci
+      - run: npm run build
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: ./dist
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - uses: actions/deploy-pages@v4
+        id: deployment
diff --git a/.gitignore b/.gitignore
@@ -1 +1,21 @@
+# Jekyll (legacy)
 _site/
+
+# Astro
+dist/
+.astro/
+
+# Dependencies
+node_modules/
+
+# Environment
+.env
+.env.*
+!.env.example
+
+# IDE
+.vscode/
+.idea/
+
+# OS
+.DS_Store
diff --git a/CLAUDE.md b/CLAUDE.md
@@ -0,0 +1,101 @@
+# CLAUDE.md - dave.coffee
+
+Personal website for Dave Worth, hosted at https://dave.coffee
+
+## Project Status
+
+**Migration in progress**: Jekyll → Astro + Tailwind CSS
+See `MIGRATION_PLAN.md` for detailed implementation plan and commit strategy.
+
+## Tech Stack
+
+### Current (Jekyll - being replaced)
+- Jekyll 3.6.3 with Kramdown markdown
+- Static CSS with Pygments syntax highlighting
+- GitHub Pages deployment
+
+### Target (Astro)
+- Astro 5.x with TypeScript strict mode
+- Tailwind CSS 4.x with Typography plugin
+- Volta for Node.js/npm version management
+- GitHub Actions for deployment
+
+## Commands
+
+```bash
+# Development (after migration)
+npm run dev          # Start dev server
+npm run build        # Build for production
+npm run preview      # Preview production build
+npm run lint         # TypeScript checking
+npm run new-post     # Create new blog post
+
+# Current Jekyll (until migration complete)
+bundle exec jekyll serve
+```
+
+## Project Structure
+
+### Target Astro Structure
+```
+src/
+├── components/      # Astro components (Header, Footer, etc.)
+├── layouts/         # Page layouts (Base, Default, Post)
+├── pages/           # Routes (index.astro, rss.xml.ts)
+├── content/posts/   # Blog posts (Markdown with frontmatter)
+└── styles/          # Global CSS with Tailwind
+public/
+├── assets/          # Static files (PDFs, images)
+└── CNAME            # Custom domain
+```
+
+### Current Jekyll Structure (to be removed)
+```
+_layouts/            # Jekyll templates
+_includes/           # Reusable partials
+_posts/              # Blog posts (6 total)
+stylesheets/         # CSS files
+assets/              # Static files
+```
+
+## Code Style
+
+- **TypeScript**: Strict mode, prefer explicit types
+- **Astro**: Use `.astro` components, avoid client-side JS unless necessary
+- **Tailwind**: Mobile-first responsive design, use design tokens from config
+- **Commits**: Conventional commits format (`type(scope): description`)
+
+## Content
+
+- 6 blog posts (2012-2015)
+- Homepage with presentations, talks, papers list
+- RSS feed at `/rss.xml`
+- Static assets: resume, thesis, conference PDFs
+
+## Design System
+
+Colors (from current site):
+- Text primary: `#777`
+- Headings: `#222`
+- Links: `#39c`
+
+Typography:
+- Font: Lato (300, 700 weights)
+- Fallbacks: Helvetica Neue, Helvetica, Arial
+
+Layout:
+- Two-column: 270px sidebar + 500px content
+- Responsive breakpoints: 480px, 720px, 960px
+
+## Git Workflow
+
+- Feature branch: `feat/astro-migration`
+- Atomic commits with conventional commit messages
+- Test before merging to `master`
+
+## Important Notes
+
+- Preserve URL structure for existing blog posts
+- RSS feed must remain compatible
+- Custom domain: dave.coffee (CNAME in public/)
+- All new code must be TypeScript
diff --git a/Gemfile b/Gemfile
diff --git a/Gemfile.lock b/Gemfile.lock
diff --git a/POST_MIGRATION_CHANGES.md b/POST_MIGRATION_CHANGES.md
@@ -0,0 +1,64 @@
+# Post-Migration Changes
+
+Changes to make after the Astro migration is complete. These are intentional deviations from the original Jekyll site.
+
+---
+
+## Content Changes
+
+### Remove GitHub Issues Discussion CTA
+
+**Location:** `src/layouts/PostLayout.astro`
+
+**Current text:**
+> Have something to contribute? Open an Issue on Github and let's have a chat!
+
+**Action:** 
+1. Remove this entire section from `PostLayout.astro`
+2. Write a new blog post reflecting on why using GitHub Issues as a discussion forum didn't work for me personally, even though some folks in the community liked the idea. Topics to cover:
+   - The original intent and optimism (reference the 2013-01-01 post)
+   - What didn't work in practice
+   - Lessons learned
+
+### Update date formatting and styling
+
+**Locations:** 
+- `src/pages/index.astro` (post listing and "Other Blog Posts and Lists" section)
+- `src/layouts/PostLayout.astro` (individual post pages)
+
+**Changes:**
+1. Format all dates as `yyyy-mm-dd` (ISO 8601 format)
+2. Style dates to be visually distinct from surrounding content - consider:
+   - Monospace font
+   - Different color or background
+
+### Unify formatting between homepage sections
+
+**Location:** `src/pages/index.astro`
+
+**Issue:** The "Other Blog Posts and Lists" section has different formatting than the main "Blog Posts, Presentations, Slide Decks, Papers, and even videos!" section.
+
+**Changes:**
+1. Apply consistent styling to both sections
+2. Use the same date format (`yyyy-mm-dd`) in both sections
+3. Match link styles, spacing, and typography between sections
+
+---
+
+## Repository Changes
+
+### Rename default branch from `master` to `main`
+
+**Steps:**
+1. Rename branch locally: `git branch -m master main`
+2. Push and set upstream: `git push -u origin main`
+3. Update default branch in GitHub repository settings
+4. Delete old remote branch: `git push origin --delete master`
+5. Update `.github/workflows/deploy.yml` to use `main` instead of `master`
+
+---
+
+## Future Improvements
+
+(Add items here as they come up during migration or testing)
+
diff --git a/README.md b/README.md
@@ -0,0 +1,75 @@
+# dave.coffee
+
+Personal website for Dave Worth, hosted at https://dave.coffee
+
+## Tech Stack
+
+- [Astro](https://astro.build/) with TypeScript
+- [Tailwind CSS](https://tailwindcss.com/) with Typography plugin
+- [Volta](https://volta.sh/) for Node.js version management
+- GitHub Actions for deployment to GitHub Pages
+
+## Prerequisites
+
+Install [Volta](https://volta.sh/) for automatic Node.js version management:
+
+```bash
+curl https://get.volta.sh | bash
+```
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Start development server
+npm run dev
+
+# Build for production
+npm run build
+
+# Preview production build
+npm run preview
+
+# TypeScript checking
+npm run lint
+```
+
+## Creating New Posts
+
+Create a new markdown file in `src/content/posts/` with the naming convention:
+
+```
+YYYY-MM-DD-post-slug.md
+```
+
+Front matter template:
+
+```yaml
+---
+title: 'Your Post Title'
+author: Dave
+published: true
+pubDate: YYYY-MM-DD
+description: 'Brief description for RSS and social sharing'
+---
+```
+
+## Project Structure
+
+```
+src/
+├── components/      # Astro components
+├── content/posts/   # Blog posts (Markdown)
+├── layouts/         # Page layouts
+├── pages/           # Routes
+└── styles/          # Global CSS
+public/
+├── assets/          # Static files (PDFs, images)
+└── CNAME            # Custom domain
+```
+
+## Deployment
+
+The site automatically deploys to GitHub Pages via GitHub Actions when changes are pushed to `master`.
diff --git a/Rakefile b/Rakefile
diff --git a/_config.yml b/_config.yml
diff --git a/_includes/github_profile_link.html b/_includes/github_profile_link.html
diff --git a/_includes/rss_link.html b/_includes/rss_link.html
diff --git a/_includes/theme_info.html b/_includes/theme_info.html