> 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="https://408624955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOEGtq1AEIEWqQF3pYMpg%2Fuploads%2FlRon4c4w4JkiPMel4wIA%2Fstream-list-diff-demo.gif?alt=media&amp;token=3e2d2e4c-7d4d-4394-bb8e-ef3fe7e4850e" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://408624955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOEGtq1AEIEWqQF3pYMpg%2Fuploads%2FJLGdGPrdf1WJ2F4eUrnF%2Fget-text-diff-demo.png?alt=media&amp;token=89b6e7af-fb05-4634-b57e-b7d2712f1ef0" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://408624955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOEGtq1AEIEWqQF3pYMpg%2Fuploads%2FDwJeWBWVWyAuMHXeCsRi%2Fget-geo-diff-demo-ok.png?alt=media&amp;token=9a5d82a8-8e25-41d5-82f2-e5bae875dc77" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://408624955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOEGtq1AEIEWqQF3pYMpg%2Fuploads%2FLrO1wyBle62EX2ZR3B6x%2Fget-object-diff-demo.png?alt=media&amp;token=5bb08520-b694-4f73-b772-76dbc2153f3f" alt=""><figcaption></figcaption></figure>

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