> For the complete documentation index, see [llms.txt](https://donedeal0.gitbook.io/superdiff/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://donedeal0.gitbook.io/superdiff/readme.md).

# WELCOME

[![CI](https://github.com/DoneDeal0/superdiff/actions/workflows/ci.yml/badge.svg)](https://github.com/DoneDeal0/superdiff/actions/workflows/ci.yml) [![CD](https://github.com/DoneDeal0/superdiff/actions/workflows/cd.yml/badge.svg)](https://github.com/DoneDeal0/superdiff/actions/workflows/cd.yml) ![NPM Downloads](https://img.shields.io/npm/dy/%40donedeal0%2Fsuperdiff?logo=npm) ![GitHub Tag](https://img.shields.io/github/v/tag/DoneDeal0/superdiff?label=latest%20release) [![Sponsor](https://img.shields.io/badge/Show%20your%20support-0d1117?style=flat\&logo=github-sponsors\&logoColor=ea4aaa\&color=3F4851)](https://github.com/sponsors/DoneDeal0)

***

**Superdiff** provides a rich and readable diff for **arrays**, **objects**, **texts** and **coordinates**. It supports **stream** and file inputs for handling large datasets efficiently, is battle-tested, has zero dependencies, and offers a **top-tier performance**.

***

<figure><img src="/files/IRXqogxLUKgALSAMvAFw" alt=""><figcaption></figcaption></figure>

<p align="center"><sub>Comparing millions of entries in real time with <code>streamListDiff</code></sub></p>

<figure><img src="/files/FPaducXnA812xdQqC31b" alt=""><figcaption></figcaption></figure>

<p align="center"><sub>Detecting text changes with <code>getTextDiff</code></sub></p>

<figure><img src="/files/yuSKGA4uHEgoPtrJ5ozE" alt=""><figcaption></figcaption></figure>

<p align="center"><sub>Tracking coordinate changes with <code>getGeoDiff</code></sub></p>

<figure><img src="/files/jNx5DOP5QugROPkZilHg" alt=""><figcaption></figcaption></figure>

<p align="center"><sub>Diffing deeply nested objects with <code>getObjectDiff</code></sub></p>