Engineering Notes
Why the engineering decisions were made. The reasoning, the trade-offs, and the failures that taught us each lesson. We collected them over decades in different shapes and forms, starting with Post-It notes and the latest maintained in our own Markdown Notes Manager connected to Github repo.
The Reepolee Approach summarizes the principles. These notes preserve the arguments, tradeoffs, and implementation decisions behind them.
Read Our ApproachWhy Bun's SQL Dies in CLI Scripts (and How to Fix It)
How Bun's internal SQL connection pool interacts with the event loop in CLI scripts, why idle connections fail to keep the process alive, and two fixes: reserve() for transaction-scoped connection affinity, setInterval() for fire-and-forget scripts. Both disappear inside Bun.serve().
Why We Use Bun and TypeScript Over Rust
On cognitive overhead, one-language stacks, and Bun's build-free TypeScript execution - why Rust's strengths don't translate to typical web application work, and why LLM-generated code needs to be readable by the team that maintains it.
The Dunning-Kruger Curve Has a Sweet Spot - and It's Hiring You Mid-Level Engineers
On the engineering talent market, why mid-level engineers compound faster than the extremes, and how AI tools specifically reward developers who are competent enough to direct them but curious enough not to trust them blindly.
Boring UI Wins
On why standardized, predictable UI wins over the life of a product - covering component learning curves, layout conventions, browser-native features, accessibility, maintenance debt, and why the best interface is the one nobody notices.
Quality Doesn't Matter ... Until It Does
Why quality standards must differ between social apps and enterprise software - and how investor pressure, low barriers to entry, and AI are driving a visible decline in the software that actually runs businesses.
On-Premise, or at Least Your Own VPS
On cost, control, privacy, GDPR, local network performance, and what happens to your business when the internet goes down or a cloud provider's building catches fire.