Home/ Field notes/ Why we still write HTML by hand
Engineering

Why we still write HTML by hand.

Templates and page builders make sites that look done. They rarely make sites that stay fast.

Code on a dark editor screen

There's a moment in most small-business website projects where someone says, “let's just use a builder.” The thinking is reasonable: builders look fast, they look cheap, and they let one person ship something visible by the end of the week. What the builders don't tell you is that the cost shows up two years from now, when the plugins start to drift and nobody can find which one is rendering the contact form.

We've inherited a lot of builder sites. Almost without exception, the pattern is the same: a respectable launch, six months of decent traffic, and then a slow slide. Pages get heavier. Plugins update on their own schedules and occasionally don't. The page-builder's CSS fights the theme's CSS, and the loser is the visitor on a phone in a parking lot.

The default failure mode of builders

It's not that page builders are bad. It's that the convenience that makes them feel cheap also makes them structurally expensive over time. Four patterns we see again and again:

None of this is hypothetical. Every one of these failures shows up in clients we inherit from other shops. The fixes are rarely fast and rarely cheap.

What custom-coded actually means

When we say a Catalyst site is custom-coded, we mean it literally. HTML, CSS, and a small amount of JavaScript — written for your site, by hand, in editor windows that look a lot like the photo at the top of this post. We use a small set of opinionated patterns we've refined across builds. We do not ship blocks of code your site never executes.

The practical effect: a typical Catalyst homepage is somewhere between 200 KB and 500 KB on first load, including images. Lighthouse scores sit in the high 90s on mobile. Time-to-interactive is under a second on a mid-range phone. None of that is magic. It's just what happens when you don't ship code you don't use.

The simplest stack that does the job is almost always the one that ages best.

A real comparison

One recent client came to us with a builder-based site we won't name. Page weight: 6.2 MB on the homepage. Largest Contentful Paint: 4.8 seconds on a throttled 4G connection. The site had 23 plugins, three of which were actively used and one of which was eight years out of date.

We rebuilt it. Same content. Same brand. Same forms. Static HTML, a single stylesheet, one short script for the mobile menu. Page weight after the rebuild: 280 KB. LCP: 0.9 seconds. The client kept their existing copy and most of their photography. Nothing about the rebuild was clever — it was just less.

When a builder is the right call

This is not a one-sided argument. Builders earn their place in three situations:

The middle path we like

The lazy critique of custom-coded sites is that the owner can never update them. That hasn't been true for years. Every Catalyst build ships with a small content-editing surface for the parts that actually change — copy, photos, blog posts, GBP-style content. Layouts and components stay in code, where they belong. Content stays in a place the owner can reach.

The result is a site that loads fast, looks consistent across devices, doesn't require monthly plugin updates, and still lets you swap out a hero photo without a developer in the loop.

It's not nostalgia

We don't hand-code sites because we're attached to a particular era of the web. We hand-code them because the trade-offs keep favoring it: less code, fewer moving parts, faster pages, calmer maintenance, better SEO. Builders will get better. Until they do, the simplest version of the work is also the durable one.

Service · 01 · Web design

Custom-coded marketing sites, $499–$1,999.

Custom-built marketing sites for Colorado small businesses. Mobile-friendly, performance-tuned, and easy to maintain. See packages and what's included.

See packages Get a quote
More from the studio

Keep reading.

All notes →
Web Open laptop on desk

The marketing-site checklist nobody hits.

Most SMB marketing sites miss four fundamentals.

May 15, 2026 · 7 min
Infra Server racks

Hosting is a feature, not a line item.

Cheap hosting compounds in the wrong direction.

Apr 3, 2026 · 6 min
Architecture Workbench

Build software around your process.

When to buy SaaS and when to build.

Apr 24, 2026 · 6 min