# lukechilds/merge-images

Easily compose images together without messing around with canvas

Repository: https://github.com/lukechilds/merge-images
Canonical: https://ross.abutalabs.com/products/merge-images
Language: JavaScript
License: MIT
License Family: permissive
Topics: canvas, image-manipulation
Last push: 2026-05-17T01:53:43+00:00

## Health v2 (maintenance only)
Score: 69/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 82, release rhythm 35, longevity 100
- inputs: {"age_days": 3506, "days_push": 109, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1710, forks 165 (observed 2026-08-28T04:05:25.669525+00:00)

## What it is
A small JavaScript library that composites multiple images into one, abstracting away canvas boilerplate into a single promise-based function call. It supports positioning, opacity, and custom dimensions, and works in both the browser and Node.js.

## Use cases
- merge multiple png images into one in the browser
- overlay images on top of each other with x/y positions
- compose avatar layers without writing canvas code
- generate a base64 data uri from combined images
- stack images with per-image opacity
- combine images server-side in node.js

## When to choose
- you need simple image merging/compositing without manual canvas handling
- you want a lightweight promise-based API returning a base64 image
- you need the same code to work in browser and Node.js

## When to avoid
- you need advanced image editing like filters, resizing, or format conversion
- you're doing heavy server-side image processing where a native library like sharp is better
- you need non-canvas output formats or streaming

## Facets
- artifact type: library
- maturity: stable
- function: image-processing
- domain: image-processing, web-development, frontend
- platform: browser
- tags: canvas, image-composition, image-merging, base64, promise-based, nodejs, javascript

## Member repositories
- lukechilds/merge-images (main) score 69

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:25.669525+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:35:13.734996+00:00, confidence not recorded.
  - readme: https://github.com/lukechilds/merge-images (fetched 2026-08-28T04:05:25.669525+00:00, sha 14d88cfd2d59)
  - registry_npm: https://registry.npmjs.org/merge-images (fetched 2026-08-29T11:11:26.991130+00:00, sha 6b28acdf1feb)
- Data as of 2026-08-30T08:39:29.467469+00:00.