Farid Yusof's Blog

You know, Go (or Golang, as some people call it) is known for its simplicity. But as your project grows, things won’t stay simple forever.

You can still maintain simplicity in your code organisation. How you structure your codebase really depends on your approach. Some developers start encapsulating things immediately, while others prefer to keep it simple at first.

When you start structuring your codebase, you might be biased-especially if you’re coming from a different ecosystem or programming “tribe.” Your structures are probably influenced by those other languages.

In the dim light of the office, long after most of the team had left, I found myself deep in conversation with my senior. We were hunched over a whiteboard, markers in hand, surrounded by a chaotic array of boxes and arrows that represented our project’s folder structure.

Months ago, we had enthusiastically crafted this structure, believing it was the blueprint for success. But as time passed, reality set in. Our once-promising structure had become a tangled web, tightly coupling components and making even the smallest changes a Herculean task.

In a bustling tech startup called KathTech Inc. (not the real name), our team was working on a highly anticipated app—one that was meant to revolutionize the way people ordered bubble tea (not a real app). Each of us brought unique ideas to the table, but there was one person who stood out: Adrian the Architect. Known for his brilliant mind, Adrian had a reputation for coming up with ideal, flawless technical solutions. The kind of solutions that made you go, “Wow, that’s genius!” —until you realized they would take three years to build.