Kamu pakai Tailwind CSS v4 di pnpm workspace dengan Next.js, lalu muncul error ini:
Error: Cannot find native binding.
Caused by: Error: Cannot find module '@tailwindcss/oxide-darwin-arm64'
Caused by: Error: Cannot find module './tailwindcss-oxide.darwin-arm64.node'
Berikut penyebabnya dan cara memperbaikinya.
Kenapa @tailwindcss/oxide tidak menemukan native binding-nya
Tailwind CSS v4 memakai @tailwindcss/oxide, engine berbasis Rust, untuk memproses CSS. Package ini dikirim sebagai wrapper yang tidak terikat platform, sedangkan binary aslinya ada di optional package seperti @tailwindcss/oxide-darwin-arm64, @tailwindcss/oxide-linux-x64-gnu, dan seterusnya.
Saat runtime, oxide/index.js mencoba memuat binary native lewat dua jalur:
// tries relative file first
require('./tailwindcss-oxide.darwin-arm64.node')
// falls back to the optional package
require('@tailwindcss/oxide-darwin-arm64')
Di setup npm atau yarn biasa, ini jalan tanpa masalah. Di pnpm workspace dengan Turbopack milik Next.js, dua-duanya gagal.
Masalah pnpm dan Turbopack
pnpm memakai isolated linker: tiap package punya node_modules sendiri yang berisi symlink ke dependency-nya. Jadi @tailwindcss/oxide-darwin-arm64 di-symlink di bawah node_modules milik oxide. Kalau kamu cd ke direktori package oxide lalu menjalankan require('@tailwindcss/oxide-darwin-arm64'), hasilnya ter-resolve dengan benar.
Masalahnya ada di Turbopack. Turbopack mengompilasi @tailwindcss/postcss dan @tailwindcss/oxide ke worker bundle terpisah di .next/dev/build/postcss.js, lalu menjalankannya di context worker yang terisolasi. Worker itu tidak mengikuti rantai symlink pnpm dengan cara yang sama, jadi dua jalur require gagal: require lewat nama package dan require lewat file relatif.
Cara memperbaikinya
Langkah 1: pastikan optional dependency-nya ter-install. pnpm kadang melewatinya. Jalankan dengan --force:
pnpm install --force
Langkah 2: salin file binary .node langsung ke direktori package oxide. Ini fix utamanya. Require relatif ./tailwindcss-oxide.darwin-arm64.node jalan di context resolusi module apa pun.
cp node_modules/.pnpm/@tailwindcss+oxide-darwin-arm64@4.3.0/node_modules/@tailwindcss/oxide-darwin-arm64/tailwindcss-oxide.darwin-arm64.node \
node_modules/.pnpm/@tailwindcss+oxide@4.3.0/node_modules/@tailwindcss/oxide/
Sesuaikan nomor versi (4.3.0) dengan versi yang ter-install di project kamu.
Langkah 3: hapus cache Next.js. Turbopack menyimpan kondisi gagal di cache, jadi walaupun fix sudah dipasang, error lama tetap muncul sampai cache dihapus:
rm -rf apps/web/.next
Restart dev server, dan error-nya hilang.
Supaya fix bertahan setelah reinstall
Binary yang disalin akan terhapus setiap kali pnpm install. Tambahkan script postinstall di package.json root:
{
"scripts": {
"postinstall": "node scripts/fix-oxide-binding.mjs"
}
}
// scripts/fix-oxide-binding.mjs
import { copyFileSync, existsSync, readdirSync } from 'node:fs'
import { join } from 'node:path'
const targets = {
'darwin-arm64': 'darwin-arm64',
'darwin-x64': 'darwin-x64',
'linux-x64': 'linux-x64-gnu',
'linux-arm64': 'linux-arm64-gnu',
}
const target = targets[`${process.platform}-${process.arch}`]
const store = 'node_modules/.pnpm'
if (!target || !existsSync(store)) process.exit(0)
const file = `tailwindcss-oxide.${target}.node`
for (const dir of readdirSync(store)) {
const match = dir.match(/^@tailwindcss\+oxide@([^_]+)/)
if (!match) continue
const version = match[1]
const src = join(store, `@tailwindcss+oxide-${target}@${version}`, 'node_modules/@tailwindcss', `oxide-${target}`, file)
const dest = join(store, dir, 'node_modules/@tailwindcss/oxide', file)
if (existsSync(src) && !existsSync(dest)) {
copyFileSync(src, dest)
console.log(`Copied ${file} into @tailwindcss/oxide@${version}`)
}
}
Script ini memproses semua versi oxide yang ter-install, jadi lockfile dengan dua versi Tailwind tidak merusak install kamu. Platform yang tercakup: darwin-arm64, darwin-x64, linux-x64, dan linux-arm64. Kalau perlu platform lain, tambahkan entry di targets.
Penyebab dan fix dalam satu paragraf
pnpm mengisolasi package di balik symlink, dan worker PostCSS milik Turbopack tidak bisa me-resolve optional native dependency lewat symlink itu. Kalau file .node disalin langsung ke direktori oxide, require relatifnya jalan, dan menghapus .next membuang cache kegagalan. Pasang script postinstall supaya fix ini diterapkan lagi di setiap install.