# KilledByAPixel/JSONCrush

Compress JSON into URL friendly strings

Repository: https://github.com/KilledByAPixel/JSONCrush
Canonical: https://ross.abutalabs.com/products/jsoncrush
Homepage: https://killedbyapixel.github.io/JSONCrush
Language: JavaScript
License: MIT
License Family: permissive
Topics: json, url-shortener, compress, javascript
Last push: 2026-02-09T23:09:33+00:00

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

## Adoption (not part of the score)
Stars 1660, forks 49 (observed 2026-08-28T04:05:18.354405+00:00)

## What it is
A tiny JavaScript library (under 2KB, zero dependencies) that compresses JSON strings into URL-friendly strings using the JSCrush algorithm, which eliminates repeated substrings and swaps characters that would be escaped in URLs. It is optimized for compressing JSON embedded in shareable URLs under 10K characters.

## Use cases
- compress json into url friendly strings
- shorten urls containing json data for sharing
- encode app state in a bookmarkable url
- reduce size of uri-encoded json query parameters
- compress json strings in the browser without dependencies

## When to choose
- you need to embed JSON in shareable or bookmarkable URLs and want better compression than base64 or lz-string
- you want a tiny, dependency-free library that works in browser and Node.js
- your JSON strings are under ~10K characters

## When to avoid
- you need to compress very large strings (>10K characters), where the algorithm becomes slow
- you need general-purpose file compression rather than URL-safe string encoding
- you need binary or non-JSON data compression

## Facets
- artifact type: library
- maturity: stable
- function: compression, serialization, json
- domain: web-development, developer-tools, files
- platform: browser
- tags: url-compression, json-compression, url-friendly-encoding, zero-dependency, shareable-urls, javascript, nodejs, web-server

## Member repositories
- KilledByAPixel/JSONCrush (main) score 52

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:18.354405+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:44:39.404653+00:00, confidence not recorded.
  - readme: https://github.com/KilledByAPixel/JSONCrush (fetched 2026-08-28T04:05:18.354405+00:00, sha 4c52a5877339)
  - homepage: https://killedbyapixel.github.io/JSONCrush (fetched 2026-08-29T11:17:22.041351+00:00, sha ca8dc70fe37d)
  - registry_npm: https://registry.npmjs.org/jsoncrush (fetched 2026-08-29T11:17:22.050564+00:00, sha 3ec10f3b6254)
- Data as of 2026-08-30T08:39:29.467469+00:00.