unjs · sxzz · Nov 3, 2025 · Aug 22, 2025 · Aug 22, 2025 · Aug 22, 2025
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -15,3 +15,36 @@ permissions: {}
 jobs:
   unit-test:
     uses: sxzz/workflows/.github/workflows/unit-test.yml@v1
+    with:
+      typecheck: pnpm run build && pnpm run typecheck
+
+  unit-test-bun:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+        with:
+          persist-credentials: false
+
+      - name: Install pnpm
+        uses: pnpm/action-setup@41ff72655975bd51cab0327fa583b6e92b6d3061 # v4.2.0
+
+      - name: Setup node
+        uses: actions/setup-node@2028fbc5c25fe9cf00d9f06a71cc4710d4507903 # v6.0.0
+        with:
+          node-version: lts/*
+          cache: pnpm
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@735343b667d3e6f658f44d0eca948eb6282f2b76 # v2.0.2
+        with:
+          bun-version: latest
+
+      - name: Install dependencies
+        run: pnpm install
+
+      - name: Build
+        run: pnpm run build
+
+      - name: Test with bun
+        run: bun run scripts/buildFixtures.ts && bun -b vitest --allowOnly
diff --git a/README.md b/README.md
@@ -15,6 +15,7 @@ Currently supports:
 - [Rspack](https://www.rspack.dev/)
 - [Rolldown](https://rolldown.rs/)
 - [Farm](https://www.farmfe.org/)
+- [Bun](https://bun.com/)
 - And every framework built on top of them.
 
 ## Documentations

diff --git a/docs/.vitepress/constant.ts b/docs/.vitepress/constant.ts
@@ -1,4 +1,4 @@
 export const title = 'Unplugin'
-export const description = 'Unified plugin system. Support Vite, Rollup, webpack, esbuild, and every frameworks on top of them.'
+export const description = 'Unified plugin system. Support Vite, Rollup, webpack, esbuild, Bun, and every frameworks on top of them.'
 export const url = 'https://unplugin.unjs.io/'
 export const ogImage = `${url}/og.png`
diff --git a/docs/README.md b/docs/README.md
@@ -6,7 +6,7 @@
 Unplugin
 </h1>
 <p align="center">
-Unified plugin system, Support Vite, Rollup, webpack, esbuild, and more
+Unified plugin system, Support Vite, Rollup, webpack, esbuild, Bun, and more
 </p>
 
 <p align="center">

diff --git a/docs/guide/index.md b/docs/guide/index.md
@@ -18,6 +18,7 @@ lastUpdated: false
 - [Rspack](https://www.rspack.dev/)
 - [Rolldown](https://rolldown.rs/)
 - [Farm](https://www.farmfe.org/)
+- [Bun](https://bun.com/)
 
 ## Trying It Online
 
@@ -153,6 +154,21 @@ export default defineConfig({
 })
 ```
 
+```ts [Bun]
+// bun.config.ts
+import Starter from 'unplugin-starter/bun'
+
+await Bun.build({
+  entrypoints: ['./src/index.ts'],
+  outdir: './dist',
+  plugins: [
+    Starter({
+      /* options */
+    }),
+  ],
+})
+```
+
 ```js [Vue-CLI]
 // vue.config.js
 module.exports = {
@@ -193,18 +209,18 @@ export default defineConfig({
 
 ## Supported Hooks
 
-| Hook                                                                              |     Rollup      | Vite | webpack |     esbuild     |     Rspack      | Farm | Rolldown |
-| --------------------------------------------------------------------------------- | :-------------: | :--: | :-----: | :-------------: | :-------------: | :--: | :------: |
-| [`enforce`](https://vite.dev/guide/api-plugin.html#plugin-ordering)               | ❌ <sup>1</sup> |  ✅  |   ✅    | ❌ <sup>1</sup> |       ✅        |  ✅  |    ✅    |
-| [`buildStart`](https://rollupjs.org/plugin-development/#buildstart)               |       ✅        |  ✅  |   ✅    |       ✅        |       ✅        |  ✅  |    ✅    |
-| [`resolveId`](https://rollupjs.org/plugin-development/#resolveid)                 |       ✅        |  ✅  |   ✅    |       ✅        | ✅ <sup>5</sup> |  ✅  |    ✅    |
-| ~~`loadInclude`~~<sup>2</sup>                                                     |       ✅        |  ✅  |   ✅    |       ✅        |       ✅        |  ✅  |    ✅    |
-| [`load`](https://rollupjs.org/plugin-development/#load)                           |       ✅        |  ✅  |   ✅    | ✅ <sup>3</sup> |       ✅        |  ✅  |    ✅    |
-| ~~`transformInclude`~~<sup>2</sup>                                                |       ✅        |  ✅  |   ✅    |       ✅        |       ✅        |  ✅  |    ✅    |
-| [`transform`](https://rollupjs.org/plugin-development/#transform)                 |       ✅        |  ✅  |   ✅    | ✅ <sup>3</sup> |       ✅        |  ✅  |    ✅    |
-| [`watchChange`](https://rollupjs.org/plugin-development/#watchchange)             |       ✅        |  ✅  |   ✅    |       ❌        |       ✅        |  ✅  |    ✅    |
-| [`buildEnd`](https://rollupjs.org/plugin-development/#buildend)                   |       ✅        |  ✅  |   ✅    |       ✅        |       ✅        |  ✅  |    ✅    |
-| [`writeBundle`](https://rollupjs.org/plugin-development/#writebundle)<sup>4</sup> |       ✅        |  ✅  |   ✅    |       ✅        |       ✅        |  ✅  |    ✅    |
+| Hook                                                                              |     Rollup      | Vite | webpack |     esbuild     |     Rspack      | Farm | Rolldown |       Bun       |
+| --------------------------------------------------------------------------------- | :-------------: | :--: | :-----: | :-------------: | :-------------: | :--: | :------: | :-------------: |
+| [`enforce`](https://vite.dev/guide/api-plugin.html#plugin-ordering)               | ❌ <sup>1</sup> |  ✅  |   ✅    | ❌ <sup>1</sup> |       ✅        |  ✅  |    ✅    |       ❌        |
+| [`buildStart`](https://rollupjs.org/plugin-development/#buildstart)               |       ✅        |  ✅  |   ✅    |       ✅        |       ✅        |  ✅  |    ✅    |       ✅        |
+| [`resolveId`](https://rollupjs.org/plugin-development/#resolveid)                 |       ✅        |  ✅  |   ✅    |       ✅        | ✅ <sup>5</sup> |  ✅  |    ✅    |       ✅        |
+| ~~`loadInclude`~~<sup>2</sup>                                                     |       ✅        |  ✅  |   ✅    |       ✅        |       ✅        |  ✅  |    ✅    |       ✅        |
+| [`load`](https://rollupjs.org/plugin-development/#load)                           |       ✅        |  ✅  |   ✅    | ✅ <sup>3</sup> |       ✅        |  ✅  |    ✅    |       ✅        |
+| ~~`transformInclude`~~<sup>2</sup>                                                |       ✅        |  ✅  |   ✅    |       ✅        |       ✅        |  ✅  |    ✅    |       ✅        |
+| [`transform`](https://rollupjs.org/plugin-development/#transform)                 |       ✅        |  ✅  |   ✅    | ✅ <sup>3</sup> |       ✅        |  ✅  |    ✅    |       ✅        |
+| [`watchChange`](https://rollupjs.org/plugin-development/#watchchange)             |       ✅        |  ✅  |   ✅    |       ❌        |       ✅        |  ✅  |    ✅    |       ❌        |
+| [`buildEnd`](https://rollupjs.org/plugin-development/#buildend)                   |       ✅        |  ✅  |   ✅    |       ✅        |       ✅        |  ✅  |    ✅    | ❌ <sup>6</sup> |
+| [`writeBundle`](https://rollupjs.org/plugin-development/#writebundle)<sup>4</sup> |       ✅        |  ✅  |   ✅    |       ✅        |       ✅        |  ✅  |    ✅    | ❌ <sup>6</sup> |
 
 ::: details Notice
 
@@ -215,6 +231,7 @@ export default defineConfig({
 3. Although esbuild can handle both JavaScript and CSS and many other file formats, you can only return JavaScript in `load` and `transform` results.
 4. Currently, `writeBundle` is only serves as a hook for the timing. It doesn't pass any arguments.
 5. Rspack supports `resolveId` with a minimum required version of v1.0.0-alpha.1.
+6. Bun's plugin API doesn't have an `onEnd` hook yet, so `buildEnd` and `writeBundle` are not supported.
 
 :::
 
@@ -253,6 +270,7 @@ export const webpackPlugin = unplugin.webpack
 export const rspackPlugin = unplugin.rspack
 export const esbuildPlugin = unplugin.esbuild
 export const farmPlugin = unplugin.farm
+export const bunPlugin = unplugin.bun
 ```
 
 ### Filters
@@ -289,14 +307,14 @@ More details can be found in the [Rolldown's documentation](https://rolldown.rs/
 
 ## Supported Context
 
-| Context                                                                               | Rollup | Vite | webpack | esbuild | Rspack | Farm | Rolldown |
-| ------------------------------------------------------------------------------------- | :----: | :--: | :-----: | :-----: | :----: | :--: | :------: |
-| [`this.parse`](https://rollupjs.org/plugin-development/#this-parse)                   |   ✅   |  ✅  |   ✅    |   ✅    |   ✅   |  ✅  |    ✅    |
-| [`this.addWatchFile`](https://rollupjs.org/plugin-development/#this-addwatchfile)     |   ✅   |  ✅  |   ✅    |   ❌    |   ✅   |  ✅  |    ✅    |
-| [`this.emitFile`](https://rollupjs.org/plugin-development/#this-emitfile)<sup>1</sup> |   ✅   |  ✅  |   ✅    |   ✅    |   ✅   |  ✅  |    ✅    |
-| [`this.getWatchFiles`](https://rollupjs.org/plugin-development/#this-getwatchfiles)   |   ✅   |  ✅  |   ✅    |   ❌    |   ✅   |  ✅  |    ✅    |
-| [`this.warn`](https://rollupjs.org/plugin-development/#this-warn)                     |   ✅   |  ✅  |   ✅    |   ✅    |   ✅   |  ✅  |    ✅    |
-| [`this.error`](https://rollupjs.org/plugin-development/#this-error)                   |   ✅   |  ✅  |   ✅    |   ✅    |   ✅   |  ✅  |    ✅    |
+| Context                                                                               | Rollup | Vite | webpack | esbuild | Rspack | Farm | Rolldown | Bun |
+| ------------------------------------------------------------------------------------- | :----: | :--: | :-----: | :-----: | :----: | :--: | :------: | :-: |
+| [`this.parse`](https://rollupjs.org/plugin-development/#this-parse)                   |   ✅   |  ✅  |   ✅    |   ✅    |   ✅   |  ✅  |    ✅    | ✅  |
+| [`this.addWatchFile`](https://rollupjs.org/plugin-development/#this-addwatchfile)     |   ✅   |  ✅  |   ✅    |   ❌    |   ✅   |  ✅  |    ✅    | ✅  |
+| [`this.emitFile`](https://rollupjs.org/plugin-development/#this-emitfile)<sup>1</sup> |   ✅   |  ✅  |   ✅    |   ✅    |   ✅   |  ✅  |    ✅    | ✅  |
+| [`this.getWatchFiles`](https://rollupjs.org/plugin-development/#this-getwatchfiles)   |   ✅   |  ✅  |   ✅    |   ❌    |   ✅   |  ✅  |    ✅    | ✅  |
+| [`this.warn`](https://rollupjs.org/plugin-development/#this-warn)                     |   ✅   |  ✅  |   ✅    |   ✅    |   ✅   |  ✅  |    ✅    | ✅  |
+| [`this.error`](https://rollupjs.org/plugin-development/#this-error)                   |   ✅   |  ✅  |   ✅    |   ✅    |   ✅   |  ✅  |    ✅    | ✅  |
 
 ::: info Notice
 
@@ -309,9 +327,9 @@ More details can be found in the [Rolldown's documentation](https://rolldown.rs/
 
 ### Bundler Supported
 
-|         Rollup         | Vite | webpack | Rspack | esbuild | Farm | Rolldown |
-| :--------------------: | :--: | :-----: | :----: | :-----: | :--: | :------: |
-| ✅ `>=3.1`<sup>1</sup> |  ✅  |   ✅    |   ✅   |   ✅    |  ✅  |    ✅    |
+|         Rollup         | Vite | webpack | Rspack | esbuild | Farm | Rolldown | Bun |
+| :--------------------: | :--: | :-----: | :----: | :-----: | :--: | :------: | :-: |
+| ✅ `>=3.1`<sup>1</sup> |  ✅  |   ✅    |   ✅   |   ✅    |  ✅  |    ✅    | ✅  |
 
 ::: details Notice
 
@@ -409,6 +427,9 @@ export const unpluginFactory: UnpluginFactory<Options | undefined> = (
     farm: {
       // Farm plugin
     },
+    bun: {
+      // Bun plugin
+    },
   }
 }
 
@@ -424,6 +445,7 @@ Each of the function takes the same generic factory argument as `createUnplugin`
 
 ```ts
 import {
+  createBunPlugin,
   createEsbuildPlugin,
   createFarmPlugin,
   createRolldownPlugin,
@@ -440,4 +462,5 @@ const esbuildPlugin = createEsbuildPlugin(/* factory */)
 const webpackPlugin = createWebpackPlugin(/* factory */)
 const rspackPlugin = createRspackPlugin(/* factory */)
 const farmPlugin = createFarmPlugin(/* factory */)
+const bunPlugin = createBunPlugin(/* factory */)
 ```
diff --git a/docs/index.md b/docs/index.md
@@ -5,7 +5,7 @@ sidebar: false
 hero:
   name: Unplugin
   text: The Unified<br>Plugin System
-  tagline: Supports Vite, Rollup, webpack, esbuild, and every framework built on top of them.
+  tagline: Supports Vite, Rollup, webpack, esbuild, Bun, and every framework built on top of them.
   image:
     light: /logo_light.svg
     dark: /logo_dark.svg
@@ -64,6 +64,12 @@ features:
     icon:
       src: /features/rolldown.svg
 
+  - title: Bun
+    details: All-in-one JavaScript runtime & toolkit
+    link: https://bun.com/
+    icon:
+      src: /features/bun.svg
+
   - title: More
     details: More supported bundlers...
     link: /guide/#supported-hooks

diff --git a/docs/public/features/bun.svg b/docs/public/features/bun.svg
diff --git a/package.json b/package.json
@@ -59,6 +59,7 @@
     "@types/picomatch": "catalog:",
     "ansis": "catalog:",
     "bumpp": "catalog:",
+    "bun-types-no-globals": "catalog:",
     "esbuild": "catalog:",
     "eslint": "catalog:",
     "eslint-plugin-format": "catalog:",

diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
diff --git a/pnpm-workspace.yaml b/pnpm-workspace.yaml
@@ -11,6 +11,7 @@ catalog:
   '@types/picomatch': ^4.0.2
   ansis: ^4.2.0
   bumpp: ^10.3.1
+  bun-types-no-globals: ^1.2.22
   esbuild: ^0.25.12
   eslint: ^9.39.0
   eslint-plugin-format: ^1.0.2

diff --git a/scripts/buildFixtures.ts b/scripts/buildFixtures.ts
@@ -5,6 +5,8 @@ import { join, resolve } from 'node:path'
 import process from 'node:process'
 import c from 'ansis'
 
+const isBun = !!process.versions.bun
+
 const dir = resolve(import.meta.dirname, '../test/fixtures')
 let fixtures = await readdir(dir)
 
@@ -16,6 +18,13 @@ for (const name of fixtures) {
   if (existsSync(join(path, 'dist')))
     await rm(join(path, 'dist')).catch(() => {})
 
+  if (isBun) {
+    console.log(c.magentaBright.inverse.bold`\n  Bun  `, name, '\n')
+    execSync('bun --version', { cwd: path, stdio: 'inherit' })
+    execSync('bun bun.config.js', { cwd: path, stdio: 'inherit' })
+    continue // skip other builders in bun environment
+  }
+
   console.log(c.yellow.inverse.bold`\n  Vite  `, name, '\n')
   execSync('npx vite --version', { cwd: path, stdio: 'inherit' })
   execSync('npx vite build', { cwd: path, stdio: 'inherit' })