Currency

Immutable, float-safe, and tree-shakeable. Built on minor-unit integers.

Get Started

API Reference

🎯

Float-safe by design

All values are stored as minor-unit integers internally. No floating-point rounding errors — ever.

🔒

Fully immutable

Every operation returns a new instance. Safe to reuse, share, and compose without side effects.

🌍

25 countries out of the box

Correct locale, separators, and fraction digits for BR, US, JP, DE, and more. See all →

🌲

Tree-shakeable

Import only what you use. Named exports ensure unused functions are excluded from your bundle.

🛡️

Typed errors

Every failure throws a typed MoneyError subclass with a machine-readable code. No silent failures.

⚡

Zero dependencies

Lightweight and self-contained. Formatting is powered by the native Intl.NumberFormat API.

Quick look

import { from, sum, total } from '@eriveltondasilva/currency'

// Create
const price = from(19.99, 'BR')
price.format() // => 'R$ 19,99'
price.applyDiscount(10).format() // => 'R$ 17,99'

// Collect
sum([10, 20, 30], 'US').format() // => '$60.00'

// Business
const items = [
  { price: 9.99, quantity: 3 },
  { price: 4.99 },
]
total(items, 'US').format() // => '$34.96'