sharp

High-performance Node.js image processing powered by libvips, built for fast resizing and format conversion.

Library
npm
v0.35.5
32,829 stars
Apache License 2.0

Repository Health

Pre-computed score based on development activity, maintenance, community, maturity, and trend momentum. How we score it →
89 /100 Excellent
Development Activity 96
Maintenance 96
Community 64
Maturity 60
Momentum 40

Technical Analysis

AI-assessed by reading the actual repository — architecture, code quality, innovation, and documentation. How we score it →
88 /100 Excellent
Architecture 88
Code Quality 90
Innovation 88
Learning Curve 85

sharp is a high-performance Node.js module for resizing, converting, and manipulating images, built on top of the libvips library. It’s typically used to convert large JPEG, PNG, WebP, AVIF, GIF, and TIFF images into smaller, web-friendly formats and dimensions, and is significantly faster than ImageMagick or GraphicsMagick for most operations because it processes images with minimal memory copying and per-operation streaming.

Beyond resizing, sharp exposes a chainable API for rotation, cropping, compositing, colour space conversion, and gamma correction, with colour spaces, embedded ICC profiles, and alpha transparency handled correctly. It ships prebuilt native bindings for common platforms so most projects can install and use it without a local build toolchain, and it works across Node.js, Deno, and Bun via Node-API.

What You Get

  • A chainable Sharp() pipeline for resize, crop, rotate, composite, and format conversion operations
  • Native bindings via libvips for JPEG, PNG, WebP, AVIF, GIF, TIFF, and SVG input/output
  • Streaming and buffer-based I/O with Promise, callback, and Node.js stream.Duplex support
  • Full TypeScript type definitions and detailed metadata/stats introspection (EXIF, ICC, dimensions)

Common Use Cases

  • Resizing and compressing user-uploaded images for web delivery in an API or CMS backend
  • Generating responsive image variants (thumbnails, srcset sizes) at build or request time
  • Converting legacy formats (BMP, TIFF) to modern web formats like WebP and AVIF

Under The Hood

Architecture

sharp is a thin, chainable JavaScript layer over the libvips C image-processing library, connected through a native Node-API addon (src/sharp.cc, src/pipeline.cc, src/operations.cc). Calling sharp(input) returns a Sharp instance (lib/constructor.mjs) that extends stream.Duplex; each chained method (lib/resize.mjs, lib/composite.mjs, lib/operation.mjs, lib/colour.mjs, lib/channel.mjs, lib/output.mjs) mutates an internal options object rather than executing immediately, and the actual decode/transform/encode pipeline only runs when a terminal method (.toFile(), .toBuffer(), or piping the stream) triggers the native binding (lib/sharp.mjs), which selects a prebuilt sharp-<platform>-<version>.node binary matching the runtime’s OS/arch/libc via detect-libc. This lazy-pipeline-then-native-execute design lets libvips process images with minimal memory copying and per-operation streaming instead of decoding a full raster buffer per JS call.

Tech Stack

The public package is pure ESM/CJS dual-published JavaScript (dist/index.mjs and dist/index.cjs from a build step) with three runtime dependencies: @img/colour, detect-libc, and semver. The native layer is C++ against libvips (>=8.18.3, declared in package.json’s config.libvips) built via node-gyp/node-addon-api, with prebuilt binaries shipped as ~15 platform-specific optionalDependencies (@img/sharp-darwin-arm64, @img/sharp-linux-x64, etc., plus matching @img/sharp-libvips-* packages) so consumers avoid a local C++ toolchain. Node.js >=20.9.0 is required, and Deno/Bun are supported through Node-API v9 compatibility.

Code Quality

The repository has 59 files under test/unit covering individual operations (resize, composite, colour, output format, etc.) plus a separate test/types directory validating the 1,999-line lib/index.d.ts TypeScript definitions, and test/leak for memory-leak regression testing — a notably rigorous setup for a native-binding library. Error handling is centralized through a shared invalidParameterError factory in lib/is.mjs, used consistently (19 call sites) across the option-validation code in resize/operation/output rather than ad hoc throws. Naming is consistent and each public option is documented with JSDoc used to generate the published API docs site.

API Design

The chainable pipeline (sharp(input).resize().jpeg().toFile()) mirrors common Node stream/builder conventions and requires almost no boilerplate to get started — a single sharp(‘in.jpg’).resize(300).toFile(‘out.jpg’) covers the primary use case. Options are grouped logically per operation (resize, composite, output-format-specific encoders) and the library supports Promise, callback, and Duplex-stream usage side by side, so it fits equally into async/await code and pipe-based stream pipelines. The extensive TypeScript definitions and inline JSDoc give strong editor autocomplete and reduce the need to consult external docs for routine operations.

Used by 109 apps in this directory

TypeScript
99%
Other

Teable

Databases · No Code Platforms

21,957

A no-code PostgreSQL database with spreadsheet UX, real-time collaboration, and native AI agents — built for teams that outgrow Airtable.

View details
80
Repo Health
76
Technical
62
Dependency
Built with
TypeScript 99%
Updated 1 weeks ago
TypeScript
95%
Other

Termix

Devops

15,870

Manage all your servers — SSH terminals, remote desktops, file transfers, and Docker containers — from a single self-hosted browser interface.

View details
84
Repo Health
67
Technical
73
Dependency
Built with
TypeScript 95%
Updated 1 weeks ago
OCaml
65%
MPL 2.0

Terrateam

Developer Tools · Devops

1,328

GitOps automation for Terraform, Pulumi, and IaC at scale

View details
86
Repo Health
72
Technical
74
Dependency
Built with
OCaml 65%
HCL 15%
TypeScript 14%
Updated 1 weeks ago
TypeScript
98%
Apache 2.0

TinaCMS

CMS

13,867

An open-source, Git-backed headless CMS that gives editors a live visual editing UI over Markdown, MDX, JSON, and YAML content while developers keep everything in version control.

View details
92
Repo Health
74
Technical
59
Dependency
Built with
TypeScript 98%
Updated 1 weeks ago
Python
69%
AGPL 3.0

Tracecat

AI Agents · Automation · Security

3,894

Open-source agentic security automation platform that runs AI agents and durable workflows at scale with sandboxed execution.

View details
89
Repo Health
88
Technical
66
Dependency
Built with
Python 69%
TypeScript 30%
Updated 1 weeks ago
TypeScript
81%
Other

twenty

CRM

60,566

The open-source CRM you build, ship, and version like the rest of your stack — with customizable objects, AI agents, and a TypeScript SDK.

View details
92
Repo Health
82
Technical
64
Dependency
Built with
TypeScript 81%
MDX 17%
Updated 1 weeks ago
TypeScript
88%
Other

Webiny JS

Blogging · CMS · Ecommerce

8,049

Open-source, self-hosted CMS on AWS serverless — a TypeScript framework you extend with code, not a product you configure through a UI.

View details
90
Repo Health
86
Technical
61
Dependency
Built with
TypeScript 88%
JavaScript 11%
Updated 1 weeks ago
TypeScript
72%
AGPL 3.0

Worklenz

Collaboration · Product Management · Project Management

3,296

All-in-one open source project management for teams who want full control — plan projects, track tasks, manage resources, and monitor finances without the SaaS lock-in.

View details
87
Repo Health
7
Technical
64
Dependency
Built with
TypeScript 72%
JavaScript 21%
Updated 1 weeks ago
TypeScript
50%
Other

World Monitor

Analytics · Monitoring

90,281

Real-time global intelligence dashboard that fuses AI-synthesized news, geopolitical risk scoring, and infrastructure tracking into one open-source situational awareness platform.

View details
87
Repo Health
89
Technical
68
Dependency
Built with
TypeScript 50%
JavaScript 48%
Updated 1 weeks ago

Join founders buildingwith open source

Opinionated takes, migration guides, cost-saving tips, and insights from the open source ecosystem.

Subscribe on Substack
Join 750+ subscribers