Platforms

Headless is a bet you should be able to explain

Going headless can be the right call. But if you can’t explain why in one plain sentence, it’s probably fashion, not fit.

Headless is a bet you should be able to explain

Because everyone is doing it

Headless, splitting the content backend from the front end that displays it, has become a default answer in some circles, reached for the way people once reached for the newest framework. My team and I have built headless setups I stand by. I’ve also talked teams out of them, because when I asked why headless, the honest answer was some version of because that’s what serious teams do now. That’s not a reason. That’s fashion wearing a reason’s clothes.

Headless is a real bet with real costs. You should be able to explain the bet in one plain sentence.

What you gain, and what you take on

The upside is genuine: freedom to serve the same content to many front ends, to pick best-in-class tools for each layer, to scale them independently. The cost is just as genuine: more moving parts, more integration, more that can drift, and usually a setup a non-technical editor can’t fully run alone. You’re trading the simplicity of one coupled system for the flexibility of several decoupled ones.

  • Good reason: you genuinely serve one body of content to a website, an app, and a kiosk, and coupling them hurts.
  • Weak reason: it feels more modern, or a conference talk said monolith like a slur.
  • The tell: if you can’t name the concrete problem it solves for you, it’s solving a problem you don’t have.
Every architecture is a trade. Headless is only right when you can name what you’re buying with the added complexity.

The cost lands on whoever maintains it

The extra parts don’t disappear after launch, they become someone’s ongoing job, which is the whole argument of the stack you choose is a bet on who maintains it and why every added layer is a promise you keep maintaining. If the flexibility isn’t being used, you have taken on the cost of a bet you never actually placed, and the boring coupled version would have shipped and run with less drama, as in boring technology is a competitive advantage.

What this means for your build

If headless solves a real, nameable problem for you, go for it with clear eyes and budget for the upkeep. If the honest reason is that it sounds right, choose the simpler thing and spend the saved complexity where it earns its keep. If you’re weighing headless against a simpler setup, I’m glad to help you name the actual trade.

Related reading

Keep reading

Have a project in mind?

Let's build something that lasts

Get in touch

Based in Manila, working with teams across time zones.