This page describes the technical details, design philosophy, and tools behind this website.
Infrastructure
- Domain registrar: Porkbun
- Hosting: GitHub Pages
- Repository: github.com/joshuapsteele/joshuapsteele.github.io
- Deployment: Automated via GitHub Actions
Tech Stack
- Static Site Generator: Hugo 0.147.3 Extended
- Theme: PaperMod by Aditya Telange
- Node.js: 18+ (local development) / 20 (CI)
- Search: Fuse.js for client-side full-text search
- Feeds: RSS and JSON Feed formats
Design Philosophy
This site embraces several web philosophies:
IndieWeb
I’m part of the IndieWeb, a community effort to keep the web independent and user-controlled. This site implements:
Identity & Discovery
Social Interactions
- Webmentions for receiving interactions from across the web
- Bridgy for backfeeding social media interactions
- Reply context display when responding to others’ posts
- Integration with Bluesky, Mastodon, and Micro.blog
Content Ownership
- POSSE workflow (Publish Own Site, Syndicate Everywhere)
- All content published here first, then syndicated
- Microformats2 markup (h-entry, h-feed) for machine readability
Digital Garden
This site incorporates digital garden principles:
- Topography over timelines: Posts are connected by topic through “Connected Notes” rather than just chronology
- Continuous growth: Content evolves over time (visible through Git history)
- Learning in public: Sharing thoughts at various stages of development
- Dense interconnections: Related posts linked through tags, categories, and content relationships
Features
- 📝 300+ blog posts organized by categories and tags
- 🔍 Full-text search with fuzzy matching
- 📱 Responsive design with dark mode support
- 💬 Multiple interaction methods: Webmentions, email, social media
- 🌿 Connected notes showing related posts by topic
- 📊 RSS and JSON feeds for syndication
- 🌐 Micro.blog integration showing recent posts on homepage
Content & Licensing
This repository uses a dual-license structure:
- Code & Configuration: MIT License - feel free to use the site’s technical implementation
- Written Content: CC BY-NC-SA 4.0 - you can share and adapt with attribution, but not for commercial purposes
Analytics & Privacy
- Analytics: Google Analytics and Tinylytics
- No tracking cookies: Analytics are privacy-respecting and aggregate
- No ads: This site is completely ad-free
- No paywalls: All content is freely accessible
Development
The site is built with modern web standards and optimized for performance:
- Image optimization: CatmullRom resampling, quality 75
- Minification: HTML, CSS, and JavaScript compressed for production
- Caching: Resource caching configured for optimal performance
- Build time: Typically under 5 seconds for full site generation
- Version control: Full Git history preserved for content evolution
Source Code
The complete source code for this site is available on GitHub:
Credits & Acknowledgments
- Static site generator: Hugo by Steve Francia and contributors
- Theme: PaperMod by Aditya Telange
- Hosting: GitHub Pages
- Domain: Porkbun
- Webmentions: Webmention.io by Aaron Parecki
- Social bridging: Brid.gy by Ryan Barrett
- IndieWeb community: For inspiration and standards
Site Evolution
This site is continuously evolving. Recent additions include:
- Enhanced webmention display with interaction counters
- Connected notes for digital garden navigation
- Reply context for threaded conversations
- Micro.blog feed integration on homepage
- Comprehensive microformats2 markup
The full history of changes is available in the Git commit log.
/colophon page is just one of my many “slash pages.”