Open notebook with technical diagrams, code snippets, and annotation marks

Guides

These guides grew out of problems we kept running into across different builds — the same semantic markup mistakes that broke screen reader navigation, the same typography choices that looked fine on desktop but fell apart on phones, the same caching headers that worked in staging but caused stale content in production. Rather than solving each one from scratch every time, we documented what worked and what failed.

Each guide covers a focused topic with practical checklists, field-tested observations from real deployments, and a short FAQ addressing the questions that came up most often. They are written for theme authors, front-end developers, and site owners who need to make confident decisions without wading through reference documentation. The goal is not to replace official specs — it is to translate them into patterns you can apply immediately.

You will notice these guides lean heavily on first-hand experience rather than theoretical best practices. Where a technique worked reliably across browsers and content types, we say so. Where it broke under specific conditions, we explain what went wrong and what we use instead. If you are building layouts, shipping themes, or optimising an existing site, start with whichever topic matches your current challenge.

Guide

WordPress Theme Structure

A structural guide to WordPress theme architecture — template hierarchy, theme.json configuration, block patterns, and the organisational decisions that determine whether a theme is maintainable or a liability.

Checklist · Field notes · FAQ
Guide

Cache and Performance

Practical caching strategies and performance optimisation for static sites — asset fingerprinting, CDN cache headers, image optimisation, and the measurement practices that separate fast sites from slow ones.

Checklist · Field notes · FAQ
Guide

SVG and UI Icons

A practical guide to implementing SVG icons in web interfaces — inline vs sprite sheets, accessibility patterns, sizing systems, and the performance tradeoffs of different icon delivery methods.

Checklist · Field notes · FAQ
Guide

Typography and Readability

Practical typography guidance for web layouts — type scale, line length, vertical rhythm, font pairing, and the readability decisions that separate professional work from amateur output.

Checklist · Field notes · FAQ
Guide

Semantic HTML Layouts

A practical guide to building page layouts with semantic HTML elements — how proper document structure improves accessibility, maintainability, and search engine comprehension.

Checklist · Field notes · FAQ