# iso-kv

> Isomorphic key-value storage with support for multiple backends

Latest version **4.0.0** (published 2026-10-02) · MIT license · 0 weekly downloads

## Install

```sh
npm install iso-kv
pnpm add iso-kv
yarn add iso-kv
bun add iso-kv
```

## Health

**Score 75/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score; high quality score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 4.0.0 |
| Published | 2026-10-02 |
| First published | 2023-09-18 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 4 |
| Unpacked size | 38.5 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| Author | Hugo Dias <hugomrdias@gmail.com> (hugodias.me) |
| Maintainers | hugomrdias |
| Keywords | kv, key-value, storage, isomorphic |

## Links

- npm: https://www.npmjs.com/package/iso-kv
- Repository: hugomrdias/iso-repo
- Homepage: https://github.com/hugomrdias/iso-repo/tree/master/packages/iso-kv
- Issues: https://github.com/hugomrdias/iso-repo/issues
- npm.io page: https://npm.io/package/iso-kv

## Dependencies (4)

- [kysely](https://npm.io/package/kysely.md) ^0.29.6
- [iso-base](https://npm.io/package/iso-base.md) ^4.4.0
- [iso-conf](https://npm.io/package/iso-conf.md) ^0.4.2
- [idb-keyval](https://npm.io/package/idb-keyval.md) ^6.3.0

## Alternatives

- [localforage](https://npm.io/package/localforage.md) — 6.2M weekly downloads
- [localforage-observable](https://npm.io/package/localforage-observable.md) — 30.8K weekly downloads
- [@y/y](https://npm.io/package/@y/y.md) — 30.1K weekly downloads
- [@metaobjectsdev/render](https://npm.io/package/@metaobjectsdev/render.md) — 3.5K weekly downloads
- [@ledgerhq/coin-algorand](https://npm.io/package/@ledgerhq/coin-algorand.md) — 1.1K weekly downloads

## Recent versions

- 4.0.0 (latest) — 2026-10-02
- 3.2.0 — 2026-05-29
- 3.1.1 — 2025-11-12
- 3.1.0 — 2025-08-27
- 3.0.3 — 2024-05-16
- 3.0.2 — 2024-03-25
- 3.0.1 — 2024-02-05
- 3.0.0 — 2024-02-05
- 2.0.0 — 2024-02-04
- 1.0.0 — 2024-01-18
- 0.2.0 — 2023-10-31
- 0.1.5 — 2023-09-18

## README

# iso-kv [![NPM Version](https://img.shields.io/npm/v/iso-kv.svg)](https://www.npmjs.com/package/iso-kv) [![License](https://img.shields.io/npm/l/iso-kv.svg)](https://github.com/hugomrdias/iso-repo/blob/main/license) [![iso-kv](https://github.com/hugomrdias/iso-repo/actions/workflows/iso-kv.yml/badge.svg)](https://github.com/hugomrdias/iso-repo/actions/workflows/iso-kv.yml)

> iso-kv is a simple key-value storage with support for multiple backend adapters (web storage, indexeddb, memory, sql, json file, etc)

## Features

- Fully typed
- TTL (time to live) for keys
- Multiple backend adapters (web storage, indexeddb, memory, sql, json file, etc)
- On change hooks
- Easy to implement new adapters
- SQL adapter uses [kysely](https://kysely.dev/)
- Namespaced keys
- Filtered and ordered listing

## Install

```bash
pnpm install iso-kv
```

## Docs

Check <https://hugomrdias.github.io/iso-repo/modules/iso_kv.html>

## License

MIT © [Hugo Dias](http://hugodias.me)

---
_Source: https://npm.io/package/iso-kv · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._