Suhailopensource — Field notes from the open-source trenches

Open-source, in the open

A modern blog where I document my open-source contributions — how I approached each issue, what I learned, and the code that shipped.

Featured

Sentry JavaScript SDKDebuggingJavaScript

The Timer Nobody Could Stop

Sentry’s tracing had two countdown timers and one place to store their handles. One timer wrote its handle into the other’s variable, and the orphaned timer went off early — quietly cutting page-load traces short and dropping everything that happened afterwards. The fix was a single variable name.

Oct 11, 20263 min read

Latest posts

One Character Was Hiding Every Healthy Process

Sentry JavaScript SDK

Debugging

Node.js

One Character Was Hiding Every Healthy Process

Sentry tracks what share of your app’s runs finish fine versus crash. In the Node SDK, a single inverted check meant every clean exit was silently dropped and every crash was reported twice. Your crash rate looked worse than it actually was. The fix was changing !== to ===.

Oct 12, 20264 min

Sentry JavaScript SDK

Debugging

JavaScript

The Timer Nobody Could Stop

Oct 11, 20263 min

The Image That Loaded in −510 Milliseconds

Google Chrome web-vitals

Web Performance

JavaScript

Open Source

The Image That Loaded in −510 Milliseconds

How long did this image take to load? Minus 510 milliseconds. That's a real number, reported by Google's web-vitals library — the one a large chunk of the web uses to measure page…

Oct 6, 20266 min

Google Chrome web-vitals

Google Chrome

You Waited Minus 98 Milliseconds

Google's web-vitals was reporting that users waited a negative amount of time for their clicks to be handled — and the three numbers still added up perfectly, which is exactly why nobody had noticed. Finding it, proving it when automated tests physically couldn't, and the exchange where a maintainer's simpler fix turned out not to work.

Aug 27, 20267 min

The One-Line "Cleanup" That Quietly Broke CLS for Everyone

Google Chrome web-vitals

Google Chrome

The One-Line "Cleanup" That Quietly Broke CLS for Everyone

Two arrow functions were deleted to shave bytes off a bundle. Each was safe alone; together they made Google's web-vitals send analytics a fake CLS of 0 every time a visitor pressed Back. Finding it, proving it against a test suite that said everything was fine, and getting the one-line fix merged into v6.2.0.

Aug 26, 202612 min

Directus

Typescript

One Character Too Few: Fixing Translation Updates in Directus

A > that should have been >=… almost. Directus refused to save any single translation row that carried both its key and its language — and the fix that looked obvious opened a second hole. Here's the walk from a false 400 to a merged patch.

Your Sortable IDs Might Not Sort

Most base62 implementations order their alphabet a-zA-Z0-9. In ASCII that isn't ascending — so a lexicographic sort silently stops matching chronological order, with no error. That bug sent me down a rabbit hole through ULID, UUIDv7, TypeID and nanoid, and eventually into writing my own ID library. Here's what I learned, including the parts where the alternatives are the better choice.

The 191-Character Bug That Wasn't About 191 Characters

A Ghost bug looked like "the alt-text limit is too short." It wasn't. Here's how reading the real defect — silent data loss, not a 191-character cap — plus one question to the maintainer turned a single-line change into a merged PR, while a bigger "raise the limit" PR was closed.

My Pull Request Is Still Open. My Code Already Shipped in Convex.

I've been reading Convex docs for three years — once, memorably, during a lecture. Then they open-sourced the backend. Nine lines later my fix for the missing URL.canParse() is live in main, and my PR is still open. Neither is a mistake.

Aug 5, 20266 min

Eclipse Theia

TypeScript

The Button That Lied: Fixing Eclipse Theia's Stale Toolbar

Eclipse Theia had a toolbar button that rendered disabled but worked the instant you clicked it. The bug wasn't in the command — it was a re-render that never ran. Here's how I traced it to two reactive signals a subclass forgot to wire up, and fixed it in @theia/toolbar.

The Comma That Leaked Styles Across an Entire IDE

A "good first issue" in Eclipse Theia looked like a one-line CSS fix — until I traced why three headings were quietly restyling the entire IDE. A short story about comma-separated selectors, global-scope leaks, and a PR that landed in Theia 1.74.0.

402 Deletions, Zero Additions: Fixing Etro's Docs by Deleting Them

issue #349 said Etro's docs wouldn't build. The right fix wasn't to repair the tooling — it was to delete it. Here's how a 402-line negative diff closed the bug.

Aug 4, 20264 min