writing
Posts and tutorials from the years this site was a blog, kept here because people still find them useful.
How This Site Pulls Live Preview Images and Devlogs from My Projects
This site reads each project's og:image and devlog from its live site, with content-hash cache busting and fallbacks, so it never needs updating by hand.
How I Add a Devlog to Every Game (and Why It's Just Markdown and HTML)
Each of my games publishes a devlog from one Markdown file. A script flags unlogged commits, the build renders the page, and this site reads it back.
From WordPress to Hugo to Next.js and Sanity: Rebuilding This Site a Third Time
This site has been WordPress, Hugo and a Next.js blog. Now it's a portfolio built on Next.js 16 and Sanity. What changed each time, and why the work leads now.
From Graphic Designer to Indie Developer: The Long Way Round
Freelance design, BMW websites, music streaming in Africa, online learning and remote digital projects, then my own products and games. What each step taught me.
Merging Duplicate Feedback Without Losing a Vote (Postgres and Prisma)
How Feedbackly merges duplicate feature requests in one Postgres transaction: moving votes and comments, removing double votes and keeping old links working.
My Indie Stack in 2026, and Why
The tools behind my three products and four games: Next.js and Vite, Postgres with Prisma or Drizzle, Clerk, Resend, Dodo Payments, Vercel and Electron.
Side Hustles, Five Years On
In 2020 I listed six reasons side projects are worth it. Five years on, I still have a day job, and the side projects now include three products and four games. Which reasons held up, and what I missed.
How I Build with AI Coding Agents as a Solo Developer
Seven projects, one developer. How I work with AI coding agents: rules in AGENTS.md, reusable skills, strict definitions of done and verification scripts.
Writing a Murder Mystery Where the Culprit Changes Every Time You Play
How Motive gives every case five complete solutions, keeps every clue fair in all of them, and uses wrong accusations to make replaying worthwhile.
From Invoicee to InvoiceAgent: What Sending My Own Invoices Taught Me
In 2023 I launched Invoicee to automate my monthly invoices. In 2026 I rebuilt it as InvoiceAgent. What changed, what I kept and why.
Rebuilding the 90s Virtual Pet
What made 90s pocket pets work, and how Piko rebuilds them: needs that decay while you're away, real stakes, growth stages and an oldest-pet leaderboard.
Designing Overdue-Invoice Reminders People Don't Hate
How InvoiceAgent chases unpaid invoices: the timing, the wording, partial payments, and the checks that stop it emailing a client who has already paid.
How ReadSprint Turns a Photo of a Book Cover into Chapter Summaries
Inside ReadSprint's summary pipeline: identifying a book from its cover, generating study sections in batches, validating every response and writing the quiz.
Building an Isometric Action RPG in the Browser with Three.js
How Ash & Oath renders a 2.5D world in Three.js: an orthographic camera, shadows fitted to the view, adaptive resolution and phone memory limits.
Pricing a Solo-Built SaaS: What I Charge for Three Products and Why
How I priced ReadSprint, Feedbackly and InvoiceAgent: free trials without a card, once-off plans next to subscriptions, and annual discounts.
Designing a Cozy Business Sim Without the Spreadsheets
How Venture Life values your company, explains every change in one sentence, and keeps a business game relaxing while it stays honest about money.
Why Feedbackly Lets Customers Post Without an Account
Requiring sign-up means losing most feedback before it's written. How Feedbackly keeps anonymous posting, voting and following useful, and where the limits are.
Shipping a Web Game as a PWA and a Desktop App from One Codebase
How Piko and Ash & Oath run in the browser, install as PWAs, and ship as signed macOS and Windows apps with Electron, all from the same code.
Building MCP Servers and Clients with Node.js and TypeScript
Build a Model Context Protocol server and client in TypeScript with the official SDK, test it in MCP Inspector, then hand its tools to Claude.
The Complete Guide to Model Context Protocol (MCP) in Python
Build an MCP server and client with the official Python SDK (v2), connect it to Claude Desktop and Claude Code, and give its tools to Claude.
MCP Explained: How the Model Context Protocol Connects AI to Tools
What the Model Context Protocol is, the problem it solves, how tools, resources and prompts work, and how quickly it spread through 2025.
Building a RESTful API with NestJS: A Complete Guide
Build a CRUD books API with NestJS: generate a resource, define DTOs, validate input, handle errors and test every endpoint.
Microservices and APIs: A Guide to Effective Architecture and API Design
How APIs hold microservices together: gateways, backends for frontends, versioning, REST vs gRPC vs events, and designing around domain boundaries.
Getting Started with the Claude API in Node.js
Call Claude from Node.js with the official Anthropic SDK: your first message, conversations, streaming, choosing a model, error handling and Express.
Getting Started with the Claude API in Python
Call Claude from Python with the official anthropic SDK: your first message, conversations, system prompts, streaming, choosing a model and errors.
Complete Guide to Using the OpenAI API using Node
Use the OpenAI API from Node.js: install the SDK, make chat completion requests, keep conversation history, stream responses and handle errors.
Complete Guide to Using the OpenAI API using Python
Use the OpenAI API from Python: install the SDK, make chat completion requests, manage conversations, generate images and handle errors.
Building APIs with Next.js Route Handlers (App Router)
Build a CRUD JSON API with Next.js 16 Route Handlers: shared data, typed async params with RouteContext, validation, status codes and query strings.
How to Use Postman for API Testing: A Complete Guide
A practical Postman walkthrough: send your first request, work with parameters, headers and auth, and write tests that check API responses.
Building a RESTful API from Scratch with Node.js (Part 8): Logging
Part 8 of 8. Add structured logging with Winston and Morgan: log levels, request IDs, rotating log files and masking sensitive data.
Building a RESTful API from Scratch with Node.js (Part 7): Pagination
Part 7 of 8. Add offset and cursor pagination to the books API, with metadata, pagination headers and tests for both approaches.
Building a RESTful API from Scratch with Node.js (Part 6): Automated Testing
Part 6 of 8. Test the API with Jest, Supertest and an in-memory MongoDB: unit, integration and end-to-end tests, coverage and GitHub Actions.
Building a RESTful API from Scratch with Node.js (Part 5): Documentation with Swagger
Part 5 of 8. Document the Node.js books API with OpenAPI, swagger-jsdoc and Swagger UI, including schemas, authentication and protected docs.
Building a RESTful API from Scratch with Node.js (Part 4): Rate Limiting
Part 4 of 8. Protect the API with express-rate-limit and Redis, stricter limits on login routes, and token bucket and fixed window algorithms.
Building a RESTful API from Scratch with Node.js (Part 3): Authentication and Roles
Part 3 of 8. Add JWT authentication, bcrypt password hashing and role-based permissions to the Node.js books API.
Building a RESTful API from Scratch with Node.js (Part 2): Adding MongoDB
Part 2 of 8. Swap the in-memory array for MongoDB and Mongoose: a Book model, async routes, search, pagination and better error handling.
Building a RESTful API from Scratch with Node.js (Part 1): Express Basics
Part 1 of 8. Set up an Express books API with CRUD routes, validation middleware and a central error handler, then test it with curl.
API Management Tools: A Comprehensive Overview
What API management tools do, the features that matter, and how Kong, Apigee, AWS API Gateway, Azure API Management, MuleSoft and Tyk compare.
API Security: Best Practices for Protecting Your Application
The common ways APIs get attacked and the practices that stop them: authentication, authorisation, rate limiting, input validation, HTTPS and logging.
API Design Best Practices: Crafting Robust and Scalable APIs
Nine API design practices: consistent naming, correct HTTP methods and status codes, versioning, pagination, error formats, security and docs.
The Importance of API Documentation and How to Create It Effectively
Why API documentation matters, what every good reference includes, and practical tips and tools for writing docs developers actually use.
A Beginner's Guide to API Integration: How It Powers Modern Applications
What API integration means, everyday examples like payments and maps, and the steps to connect your app to a third-party API for the first time.
How APIs Work: A Beginner’s Guide
How a request travels to an API and back: endpoints, HTTP methods, headers, status codes, JSON responses and authentication, explained simply.
Types of APIs: A Comprehensive Overview
Open, internal, partner and composite APIs, plus REST, SOAP and GraphQL: what each type is, where it fits and what to watch out for.
What is an API?
A plain-English answer to "what is an API?", with everyday examples from ride-hailing apps, online payments and maps.
API Basics: A Beginner's Guide
The core API concepts for beginners: requests and responses, HTTP methods, endpoints, data formats and authentication, and how to make your first call.
Invoicee Beta is Live!
Invoicee, my app for automating monthly invoices with live currency conversion and emailed PDFs, is now in beta. Here's what it does.
Why use Ackee instead of Google Analytics?
Ackee is a self-hosted, open-source analytics tool that collects no personal data. Here's how it compares with Google Analytics.
Benefits of Using Open Source Analytics
The benefits of open-source web analytics: owning your data, protecting user privacy, controlling costs and tracking what matters to you.
Goodbye WordPress!
Why I moved my site from WordPress to Hugo and Netlify, with Lighthouse scores before and after and what it did to my yearly costs.
WordPress vs Next.js
WordPress or Next.js for your next website? A comparison of performance, cost, ease of development and security.
Is WordPress Dead?
Is WordPress dead? Where I think it still fits, and why I was moving to Gatsby, Next.js and headless CMSs like GraphCMS.
What Does It Mean to Be a Developer?
Being a developer is more than writing code. Three questions to ask before building anything: why are we building it, for whom, and with what?
Benefits of Side Hustles
Why side projects are worth it for developers: new skills, new ways of thinking, low-risk business ideas, a cure for boredom and extra income.
A Different Approach to Deadlines in Development
Deadlines don't have to mean stress. Breaking a project into dated, purposeful steps makes deadlines easier to hit and earlier to renegotiate.
The Importance of Having a Development Process
Why development teams need a real process and not just "Agile", and an example process that keeps teams in sync and quality high.
Using Gatsby & Netlify to Create and Deploy a Website
How I built and deployed a marketing site with Gatsby.js and Netlify in 2019: starters, plugins, Netlify CMS and Netlify's asset optimisation.
Using and Learning React for 2 Years, What Have I Learnt?
What two years of React taught me: the JavaScript to learn first, why Webpack matters, state, containers vs components, and deploying.
The Magic of Development Tools in Chrome and Safari
A tour of Chrome and Safari developer tools: inspecting elements, the console, sources, the network panel, storage and responsive device modes.
My Collection of Web Design/Dev Resources [Updated]
The web design and development resources I keep coming back to: apps, services, websites and references, from Balsamiq and Sketch to Devhints.
WTF is GitHub and How Does it Work?
A beginner's guide to Git and GitHub: create an account and a repo, commit and push code, add a .gitignore and licence, branch and open a pull request.