feat: migrate from Node.js/npm to Bun #149

MiltonTulli · 2026-01-14T15:06:56Z

Description

Migrate the project tooling from Node.js/npm + Webpack to Bun + Vite for faster builds, better developer experience, and modern tooling.

Related Issue

Type of Change

Changes Made

Core Migration

Replace npm with Bun as package manager and runtime
Replace Webpack with Vite as bundler
Update all scripts to use Bun commands
Change dev server port from 3030 to 3000
Replace jsdom with happy-dom for Vitest (ESM compatibility)

Files Changed

File	Change
`package.json`	Add `packageManager`, update scripts, remove eslintConfig, restore `build:development`
`bunfig.toml`	New Bun configuration
`vite.config.ts`	New Vite configuration (replaces webpack.config.js)
`index.html`	Moved from public/ to root (Vite requirement), fixed opensearch link
`vitest.config.ts`	Changed environment to happy-dom
`playwright.config.ts`	Updated port and commands
`scripts/*.sh`	Updated to use Bun commands
`.github/workflows/*.yml`	Migrated from setup-node to setup-bun
`README.md`, `CLAUDE.md`, `CONTRIBUTING.md`	Updated documentation

Removed

.nvmrc - No longer needed
package-lock.json - Replaced by bun.lock
webpack.config.js - Replaced by Vite
eslintConfig in package.json - Using Biome

Screenshots (if applicable)

N/A - Tooling change, no UI changes

Checklist

I have run bun run format:fix and bun run lint:fix
I have run bun run typecheck with no errors
I have run tests with bun run test:run
I have tested my changes locally
I have updated documentation if needed
My code follows the project's architecture patterns

Additional Notes

Test Results

bun install - Installs dependencies correctly
bun start - Dev server runs on port 3000
bun run build - Production build succeeds
bun run test:run - All tests pass
bun run typecheck - No TypeScript errors
bun run format && bun run lint - No issues

CI Status Note

The build-and-deploy (PR Preview) check is expected to fail until this PR is merged. This is because deploy-pr-preview.yml uses pull_request_target, which executes the workflow from the base branch (main), not the PR branch. Once merged, future PRs will use the correct Bun configuration.

Node.js Usage

The only remaining Node.js usage is in .github/workflows/hash-deploy-build.yml for the custom Pinata deploy action, which requires Node.js runtime for GitHub Actions.

AugustoL · 2026-01-14T17:15:54Z

@MiltonTulli Thanks a lot for the PR, im in for a change on stack, but what would be the pros of changing to bun & vite?
Since this decision will impact the entire codebase of the explorer, we will also need the approval of @MatiasOS as well.

- Change dev server port back to 3030 (vite.config.ts, playwright.config.ts) - Add overrides for @noble/hashes and @noble/curves to fix version conflict - Update package.json scripts to call tools directly (no bun run prefix) - Update all docs to use npm run/start commands while keeping bun install - Update shell scripts to use npm run and correct port 3030

MatiasOS · 2026-01-20T14:15:04Z

I'm testing this branch, and it seems to be working quite well. I'm in for this change too

There are still some references to npm. I don't know what you, @AugustoL, discussed with @MiltonTulli, but if my comments are fix we should merge so I can continue with #146 and #118

MatiasOS · 2026-01-20T14:29:27Z

README.md

 ```bash
-# Run with npm script
+# Run with bun script
 npm run dev


Here are some references to npm still.
Should some commands still run with npm?

Yes, i specifically left the commands to be run with npm, I think it is better since we use it as an alias command and later on the package.json we can define the entire command to be run, and in case it changes we change it only on one place

MatiasOS · 2026-01-20T14:30:07Z

package.json

+		"build": "vite build",
 		"build:production": "bash ./scripts/build-production.sh",
 		"build:staging": "bash ./scripts/build-staging.sh",
-		"build:development": "webpack --config webpack.config.js --mode development",


Why is this command removed?

Mistake, going to add it back

commited here 4bd5164

MatiasOS · 2026-01-20T14:31:53Z

playwright.config.ts

  // These are injected into localStorage by the test fixture (e2e/fixtures/test.ts)
  webServer: {
-    command: "npm start",
+    command: "npm run start",


If tests e2e still use npm, should we keep the .nvmrc file?

MatiasOS · 2026-01-20T14:34:11Z

.github/workflows/hash-deploy-build.yml

+      - name: Setup Node.js for deploy action
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'


We should keep using Node LTS if possible

We use this version cause is what the deploy to ipfs needs to run, it wont affect or require to have nodejs installed locally. This is the only place where nodejs is used, we can leave it as it is.

MatiasOS · 2026-01-20T14:39:12Z

CONTRIBUTING.md

 3. Install dependencies:
   ```bash
-   npm install
+   bun install


Should we update all this section to use bun instead of npm?

It uses bun for install, which is compatible with npm install. And te rest of the contirbuting file doesnt mention nodejs.

…-setup

MatiasOS

feat: migrate from Node.js/npm to Bun with Vite bundler

75744fb

AugustoL added 2 commits January 18, 2026 20:24

Merge openscan-explorer/dev into feature/bun-setup

d1d9d76

MatiasOS mentioned this pull request Jan 20, 2026

feat: Auto-inject contract artifacts in dev mode #146

Open

MatiasOS reviewed Jan 20, 2026

View reviewed changes

AugustoL added 4 commits January 20, 2026 13:00

fix(scripts): restore build:development script for vite

4bd5164

merge: dev branch with opensearch support (fix webpack syntax for vite)

8ec2a21

Merge remote-tracking branch 'openscan-explorer/dev' into feature/bun…

085ee9b

…-setup

feat(scripts): add npm audit script for bun projects

5502d41

MatiasOS approved these changes Jan 20, 2026

View reviewed changes

AugustoL merged commit 3c631cd into openscan-explorer:dev Jan 20, 2026
2 of 4 checks passed

This was referenced Jan 20, 2026

fix(webpack): add content hash to chunks and optimize dev builds #153

Closed

v1.1.0-a #150

Merged

feat: migrate from Node.js/npm to Bun #149

feat: migrate from Node.js/npm to Bun #149

Uh oh!

Conversation

MiltonTulli commented Jan 14, 2026 • edited by AugustoL Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Related Issue

Type of Change

Changes Made

Core Migration

Files Changed

Removed

Screenshots (if applicable)

Checklist

Additional Notes

Test Results

CI Status Note

Node.js Usage

Uh oh!

AugustoL commented Jan 14, 2026

Uh oh!

MatiasOS commented Jan 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

MatiasOS left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

MiltonTulli commented Jan 14, 2026 •

edited by AugustoL

Loading

MatiasOS commented Jan 20, 2026 •

edited

Loading