Personal website for Stephen McCullough, built with Astro and deployed to GitHub Pages.

🌐 Visit Site

• 📝 Blog and notes sections with Markdown support
• 🌓 Dark/light mode toggle with system preference detection
• 🎨 Clean, minimalist design using Tailwind CSS
• 🚀 Fast loading with minimal JavaScript
• 📱 Fully responsive
• 📡 RSS feed for blog posts and notes
• 🗺️ Automatic sitemap generation
• 🔍 SEO optimised with meta tags and Open Graph support

• Node.js 20 or later
• npm or pnpm
• make (optional, for using Makefile commands)

make local.install
# or
npm install

make local.dev
# or
npm run dev

Open http://localhost:4321 to see the site.

make local.build
# or
npm run build

The built site will be in the dist/ directory.

make local.preview
# or
npm run preview

make local.check        # Run Astro type checking
make local.clean        # Clean build artifacts
make branch             # Show current git branch

End-to-end tests are written with Playwright and run against the built site.

npm run test

npm run test:ui

• Homepage loads correctly
• Navigation links work
• Dark mode toggle
• Writing/Blog pages (list and individual posts)
• Notes pages (list and individual notes)
• Now page
• About page
• Projects page
• RSS feed accessibility
• Basic accessibility (heading hierarchy, image alt text)

Tests run automatically on pull requests via GitHub Actions.

Use the Makefile shortcut (recommended):

make content.writing

This will prompt you for the title, description, slug, and tags, then create the file with proper frontmatter and open it in your editor.

Or manually create a new Markdown file in src/content/writing/:

---
title: "Your Post Title"
description: "Brief description for SEO"
pubDate: 2025-11-05
tags: ["typescript", "astro"]
---

Your content here...

Use the Makefile shortcut (recommended):

make content.note

This will prompt you for the title, slug, and tags, then create the file with proper frontmatter and open it in your editor.

Or manually create a new Markdown file in src/content/notes/:

---
title: "Quick Note About X"
pubDate: 2025-11-05
tags: ["javascript"]
---

Brief content...

Use the Makefile shortcut (recommended):

make content.thought

This will prompt you for the slug and optional tags, then create the file with proper frontmatter (including current time) and open it in your editor.

Or manually create a new Markdown file in src/content/thoughts/:

---
pubDate: 2025-11-05
pubTime: "18:30"
tags: ["meta"]
---

Your thought here...

Edit src/content/now/current.md:

---
updatedDate: 2025-11-05
---

## What I'm up to

Currently working on...

The site automatically deploys to GitHub Pages when you push to the main branch.

make production.deploy
# or
git push origin main

make production.logs      # View recent GitHub Actions runs
make production.status    # View current deployment status

1. Go to your GitHub repository Settings → Pages
2. Under "Build and deployment", select "GitHub Actions"
3. Under "Custom domain", enter swm.cc
4. Ensure DNS is configured with a CNAME record pointing to your GitHub Pages URL

/
├── .github/workflows/   # GitHub Actions deployment
├── public/              # Static assets
├── src/
│   ├── components/      # Reusable Astro components
│   ├── content/         # Markdown content
│   │   ├── blog/
│   │   ├── notes/
│   │   └── now/
│   ├── layouts/         # Page layouts
│   ├── pages/           # Routes (becomes URLs)
│   ├── styles/          # Global styles
│   └── utils/           # Helper functions
├── astro.config.mjs     # Astro configuration
├── claude.md            # Project documentation
└── package.json

• Framework: Astro v5
• Styling: Tailwind CSS v4
• Content: Markdown with frontmatter
• Deployment: GitHub Pages via GitHub Actions
• Domain: swm.cc (custom domain)

See claude.md for detailed project documentation, including:

• Architecture decisions
• Content workflow
• Maintenance guidelines
• Troubleshooting

Content: All rights reserved Code: MIT Licence