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

Google Chrome web-vitalsGoogle 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 read

Latest posts

Google Chrome web-vitals

Google Chrome

You Waited Minus 98 Milliseconds

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

Voiden

Typescript

How I Taught Voiden's CLI to Read YAML Env Files — My First Open-Source Contribution

My first open-source contribution: Voiden's runner claimed to support YAML env files but silently broke on them. Here's how I traced the bug, fixed it cleanly, and what shipping it taught me about testing and reading code.

Aug 3, 20264 min

Browse by tag

Subscribe for new contributions

Get an email when I publish a new open-source write-up — how I approached the issue, the code, and lessons learned. No spam.