The terminal aesthetics of good error handling
> An error message is a surface too. A good error informs, reassures, and points a way out, even a 404.
dateSep 5, 2025
read5 m · read
tagsUXerror-handlingdesign
Most developers treat the error message as an afterthought. But the moment of failure is exactly when the user is most vulnerable, and that's when what you write there matters most.
##What a good error says
- →What happened, in human language, not just the code.
- →That it's not necessarily the user's fault.
- →What they can do now: one concrete next step.
I did exactly this on my own portfolio: the 404 is a shell error, with ENOENT and an exit code, but underneath there are always two directions you can go next.
bash
$ cd ~/works/this-page
cd: no such file or directory: this-page
# → cd ~ back to home
# → ls ~/works browse the worksLet the form match the product. On a terminal portfolio, even the error is a terminal. Consistency itself is reassuring.