Why does sharp fail on macOS Apple Silicon?

Sharp versions like 0.34.x ship with prebuilt binaries that have an ABI mismatch with Node v25 native files on arm64 architectures, leading to installation or runtime errors.

Does this skill require manual file editing?

The skill provides the exact JSON and INI snippets needed for package.json and .npmrc, which Claude can help apply directly to your project.

What version of Node.js is this skill intended for?

This skill is specifically designed for environments running Node.js v25 and higher where native module compatibility issues are most prevalent.

Which package managers are supported by this fix?

The fix provides specific instructions for both pnpm and npm, including the correct syntax for overrides and .npmrc configurations.

Cloudflare Workers macOS Fix

Name: Cloudflare Workers macOS Fix
Author: jaeyeom

byjaeyeom

0•

Cloud Infrastructure

Resolves sharp native module installation errors on Apple Silicon Macs when setting up Cloudflare Workers projects.

This skill provides a specialized solution for developers encountering 'sharp' package failures during Cloudflare Workers setup on macOS arm64 architectures with Node.js v25+. It automates the process of pinning compatible dependency versions, configuring .npmrc for platform-specific binaries, and ensuring necessary build dependencies are present to prevent ABI mismatches and native module load errors common in recent Node.js environments.

Key Features

01Step-by-step resolution for Wrangler installation failures

02Compatibility support for both pnpm and npm package managers

03Platform-specific .npmrc configuration for Apple Silicon (darwin-arm64)

040 GitHub stars

05Automated version pinning for sharp to resolve ABI mismatches

06Build dependency management for node-addon-api

Use Cases

01Troubleshooting 'sharp' and 'wrangler' installation errors in Node v25+

02Resolving native module load errors referencing darwin-arm64

03Setting up a new Cloudflare Workers environment on an M1, M2, or M3 Mac

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jaeyeom/claude-toolbox cloudflare-macos-fix

For use in Claude.ai and ChatGPT

Key Features

01Step-by-step resolution for Wrangler installation failures

02Compatibility support for both pnpm and npm package managers

03Platform-specific .npmrc configuration for Apple Silicon (darwin-arm64)

040 GitHub stars

05Automated version pinning for sharp to resolve ABI mismatches

06Build dependency management for node-addon-api

Use Cases

01Troubleshooting 'sharp' and 'wrangler' installation errors in Node v25+

02Resolving native module load errors referencing darwin-arm64

03Setting up a new Cloudflare Workers environment on an M1, M2, or M3 Mac

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jaeyeom/claude-toolbox cloudflare-macos-fix

For use in Claude.ai and ChatGPT