# scurker/currency.js

A javascript library for handling currencies

Repository: https://github.com/scurker/currency.js
Canonical: https://ross.abutalabs.com/products/currencyjs
Homepage: https://currency.js.org
Language: JavaScript
License: MIT
License Family: permissive
Topics: currency-values, javascript, javascript-library, money, currency
Last push: 2026-08-26T17:54:39+00:00

## Health v2 (maintenance only)
Score: 67/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 8, longevity 100
- inputs: {"age_days": 4857, "days_push": 7, "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 3382, forks 144 (observed 2026-08-28T04:07:58.652834+00:00)

## What it is
currency.js is a lightweight (~1kb) JavaScript library for handling currency values, working around JavaScript's floating point precision issues by operating on integers behind the scenes. It offers an immutable, chainable API with flexible formatting and accepts numbers, strings, or other currency instances as input.

## Use cases
- add and subtract money without floating point errors
- format currency values with custom symbols and separators
- parse currency strings like '$12.30' or '£1,234,567.89'
- convert minor units like cents into decimal currency values
- perform safe arithmetic on prices in an e-commerce app
- chain multiple currency calculations immutably

## When to choose
- you need precise decimal arithmetic for money in JavaScript
- you want a tiny, zero-dependency currency utility
- you need flexible currency formatting and parsing
- you want an immutable API for currency math

## When to avoid
- you need arbitrary-precision decimal math beyond 2^53 cents
- you need multi-currency exchange rates or conversion
- you need full decimal arithmetic for non-currency values
- you need a big-number library for scientific computation

## Facets
- artifact type: library
- maturity: stable
- function: serialization, math, developer-tools
- domain: web-development, frontend, fintech, developer-tools
- platform: browser, cross-platform
- tags: currency, money, floating-point, immutable, zero-dependencies, formatting, nodejs, javascript

## Member repositories
- scurker/currency.js (main) score 67

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:58.652834+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-29T18:39:40.553383+00:00, confidence not recorded.
  - readme: https://github.com/scurker/currency.js (fetched 2026-08-28T04:07:58.652834+00:00, sha f97a0da1c203)
  - homepage: https://currency.js.org (fetched 2026-08-29T09:33:22.634045+00:00, sha eee9665ef842)
- Data as of 2026-08-30T08:39:29.467469+00:00.