perf(deps): replace debug with obug #21107

sxzz · 2025-11-11T23:09:12Z

https://github.com/sxzz/obug is a newly developed project, forked from debug, the most popular npm library for debugging.

obug addresses several issues:

Built-in TypeScript support—no need to install @types/debug (More accurate)
Zero dependencies, achieved by dropping support for legacy browsers and older Node.js versions
- Optimized for modern environments
- Supports ES2015+ browsers
- Compatible with Node.js 20.19 and above
Pure ESM
Extremely small footprint
- Unpacked size: 21 KB vs 42 KB (including dependencies)
- Production bundle size for browsers: only 3.22 kB, gzip: 1.5kB.
Uses trusted publishing (although some consider this meaningless, this is simply to inform those who care about it; related discussions are outside the scope of this post)

Since Vite inlines debug into its bundle, users won't notice any difference, and it also reduces the installation size by 4.7 kB (gzipped).

See e18e/ecosystem-issues#217 for discussion

sapphi-red · 2025-11-12T02:17:04Z

It seems the package size gets slightly bigger 🤔

Before

npm notice name: vite
npm notice version: 7.2.2
npm notice filename: vite-7.2.2.tgz
npm notice package size: 546.2 kB
npm notice unpacked size: 2.3 MB
npm notice shasum: f1f10e937d6eb0dd83b26799ecc864a0a1d23038
npm notice integrity: sha512-eygGzQ9DwAdKM[...]6Vgr/lwA2lchA==
npm notice total files: 39

After

npm notice name: vite
npm notice version: 7.2.2
npm notice filename: vite-7.2.2.tgz
npm notice package size: 548.7 kB
npm notice unpacked size: 2.3 MB
npm notice shasum: 317bc74ee2cef38ea7ff6792ddb2cf5056d5d107
npm notice integrity: sha512-27C3Tg9WiObNw[...]v/eEC8KA/+lOw==
npm notice total files: 39

I took these by pnpm i && pnpm build && npm pack.

bluwy · 2025-11-12T03:09:17Z

I'm guessing other deps are using debug too, so it all gets deduped and this new package only adds on top of it.

sxzz · 2025-11-12T14:05:16Z

I replaced all versions of debug (including older versions) with obug. While older versions of debug share the same APIs, the main difference is their support for legacy Node.js.

npm notice package size: 542.8 kB
npm notice unpacked size: 2.2 MB

-rw-r--r--@ 1 kevin  staff  542803 Nov 12 22:02 after.tgz
-rw-r--r--@ 1 kevin  staff  547558 Nov 12 18:58 before.tgz

❯ dua before after --format bytes
   2351104 b after
   2367488 b before

Reduced by 4,766 bytes (gzipped), 16,384 bytes (decompressed)

sxzz · 2025-11-12T14:06:33Z

I'm currently using monkeypatch to require obug as a temporary workaround. We can remove this fix once rolldown/rolldown#4997 is resolved. /cc @sapphi-red

pnpm-workspace.yaml

This reverts commit acfe939.

sapphi-red · 2025-11-20T07:20:00Z

@sxzz I haven't checked the reason, but I've reverted this PR as the CI failed: 2d66b7b

sxzz · 2025-11-20T07:21:46Z

You upgraded obug to v2 in this commit
a668014

sapphi-red · 2025-11-20T07:26:03Z

Hmm, true. It seems if I run pnpm i the lockfile that was committed is generated.

| datasource | package | from | to | | ---------- | ------- | ----- | ----- | | npm | vite | 7.2.2 | 7.2.4 | ## [v7.2.4](https://github.com/vitejs/vite/blob/HEAD/packages/vite/CHANGELOG.md#small-724-2025-11-20-small) ##### Bug Fixes - revert "perf(deps): replace debug with obug ([#21107](vitejs/vite#21107))" ([2d66b7b](vitejs/vite@2d66b7b)) ## [v7.2.3](https://github.com/vitejs/vite/blob/HEAD/packages/vite/CHANGELOG.md#small-723-2025-11-20-small) ##### Bug Fixes - allow multiple `bindCLIShortcuts` calls with shortcut merging ([#21103](vitejs/vite#21103)) ([5909efd](vitejs/vite@5909efd)) - **deps:** update all non-major dependencies ([#21096](vitejs/vite#21096)) ([6a34ac3](vitejs/vite@6a34ac3)) - **deps:** update all non-major dependencies ([#21128](vitejs/vite#21128)) ([4f8171e](vitejs/vite@4f8171e)) ##### Performance Improvements - **deps:** replace debug with obug ([#21107](vitejs/vite#21107)) ([acfe939](vitejs/vite@acfe939)) ##### Miscellaneous Chores - **deps:** update dependency [@rollup/plugin-commonjs](https://github.com/rollup/plugin-commonjs) to v29 ([#21099](vitejs/vite#21099)) ([02ceaec](vitejs/vite@02ceaec)) - **deps:** update rolldown-related dependencies ([#21095](vitejs/vite#21095)) ([39a0a15](vitejs/vite@39a0a15)) - **deps:** update rolldown-related dependencies ([#21127](vitejs/vite#21127)) ([5029720](vitejs/vite@5029720))

| datasource | package | from | to | | ---------- | ------- | ----- | ----- | | npm | vite | 7.2.2 | 7.2.6 | ## [v7.2.6](https://github.com/vitejs/vite/blob/HEAD/packages/vite/CHANGELOG.md#small-726-2025-12-01-small) #### <small>[7.2.6](vitejs/vite@v7.2.5...v7.2.6) (2025-12-01)</small> ## [v7.2.4](https://github.com/vitejs/vite/blob/HEAD/packages/vite/CHANGELOG.md#small-724-2025-11-20-small) ##### Bug Fixes - revert "perf(deps): replace debug with obug ([#21107](vitejs/vite#21107))" ([2d66b7b](vitejs/vite@2d66b7b)) ## [v7.2.3](https://github.com/vitejs/vite/blob/HEAD/packages/vite/CHANGELOG.md#small-723-2025-11-20-small) ##### Bug Fixes - allow multiple `bindCLIShortcuts` calls with shortcut merging ([#21103](vitejs/vite#21103)) ([5909efd](vitejs/vite@5909efd)) - **deps:** update all non-major dependencies ([#21096](vitejs/vite#21096)) ([6a34ac3](vitejs/vite@6a34ac3)) - **deps:** update all non-major dependencies ([#21128](vitejs/vite#21128)) ([4f8171e](vitejs/vite@4f8171e)) ##### Performance Improvements - **deps:** replace debug with obug ([#21107](vitejs/vite#21107)) ([acfe939](vitejs/vite@acfe939)) ##### Miscellaneous Chores - **deps:** update dependency [@rollup/plugin-commonjs](https://github.com/rollup/plugin-commonjs) to v29 ([#21099](vitejs/vite#21099)) ([02ceaec](vitejs/vite@02ceaec)) - **deps:** update rolldown-related dependencies ([#21095](vitejs/vite#21095)) ([39a0a15](vitejs/vite@39a0a15)) - **deps:** update rolldown-related dependencies ([#21127](vitejs/vite#21127)) ([5029720](vitejs/vite@5029720))

sxzz force-pushed the perf/obug branch from 9b53931 to 5198377 Compare November 11, 2025 23:12

sxzz force-pushed the perf/obug branch from 5198377 to e576244 Compare November 12, 2025 12:21

sxzz marked this pull request as draft November 12, 2025 12:43

sxzz force-pushed the perf/obug branch 3 times, most recently from 9fb3089 to 11397ac Compare November 12, 2025 14:01

sxzz marked this pull request as ready for review November 12, 2025 16:44

This was referenced Nov 15, 2025

perf: replace debug with obug antfu-collective/vite-node#13

Merged

perf: replace debug with obug vuejs/vitepress#5030

Merged

Replace debug with obug e18e/ecosystem-issues#217

Open

sxzz force-pushed the perf/obug branch from de1b510 to 7901fc7 Compare November 17, 2025 20:04

graphite-app bot reviewed Nov 17, 2025

View reviewed changes

pnpm-workspace.yaml Show resolved Hide resolved

sxzz mentioned this pull request Nov 19, 2025

perf: replace debug with obug vitejs/vite-plugin-vue#705

Merged

9 tasks

sxzz added 5 commits November 19, 2025 12:40

perf: replace debug with obug

ce24fe9

overrides

a0aff46

fix

9a5a716

chore: upgrade obug

1ab1c4f

chore: upgrade rolldown

999a7b7

sxzz force-pushed the perf/obug branch from 7901fc7 to 999a7b7 Compare November 19, 2025 04:42

sxzz mentioned this pull request Nov 19, 2025

perf: replace debug with obug vitest-dev/vitest#9057

Merged

7 tasks

upgrade

c56e4a5

sapphi-red changed the title ~~perf: replace debug with obug~~ perf(deps): replace debug with obug Nov 19, 2025

sapphi-red added dependencies Pull requests that update a dependency file p2-nice-to-have Not breaking anything but nice to have (priority) labels Nov 19, 2025

sapphi-red approved these changes Nov 19, 2025

View reviewed changes

sapphi-red merged commit acfe939 into vitejs:main Nov 19, 2025
19 checks passed

sxzz deleted the perf/obug branch November 19, 2025 07:50

sxzz mentioned this pull request Nov 19, 2025

perf: replace debug with obug sveltejs/vite-plugin-svelte#1241

Merged

sapphi-red added a commit that referenced this pull request Nov 20, 2025

fix: revert "perf(deps): replace debug with obug (#21107)"

2d66b7b

This reverts commit acfe939.

sxzz mentioned this pull request Nov 20, 2025

perf(deps): replace debug with obug #21137

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!

perf(deps): replace debug with obug #21107

perf(deps): replace debug with obug #21107

Uh oh!

sxzz commented Nov 11, 2025 •

edited

Loading

Uh oh!

sapphi-red commented Nov 12, 2025

Uh oh!

bluwy commented Nov 12, 2025

Uh oh!

sxzz commented Nov 12, 2025 •

edited

Loading

Uh oh!

sxzz commented Nov 12, 2025

Uh oh!

Uh oh!

Uh oh!

sapphi-red commented Nov 20, 2025

Uh oh!

sxzz commented Nov 20, 2025

Uh oh!

sapphi-red commented Nov 20, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Uh oh!

perf(deps): replace debug with obug #21107

perf(deps): replace debug with obug #21107

Uh oh!

Conversation

sxzz commented Nov 11, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

sapphi-red commented Nov 12, 2025

Uh oh!

bluwy commented Nov 12, 2025

Uh oh!

sxzz commented Nov 12, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

sxzz commented Nov 12, 2025

Uh oh!

Uh oh!

Uh oh!

sapphi-red commented Nov 20, 2025

Uh oh!

sxzz commented Nov 20, 2025

Uh oh!

sapphi-red commented Nov 20, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

sxzz commented Nov 11, 2025 •

edited

Loading

sxzz commented Nov 12, 2025 •

edited

Loading