# typicode/lowdb

Simple and fast JSON database

Repository: https://github.com/typicode/lowdb
Canonical: https://ross.abutalabs.com/products/lowdb
Language: JavaScript
License: MIT
License Family: permissive
Topics: database, lodash, nodejs, localstorage, electron, json, embedded-database, embeddable, javascript, storage
Last push: 2026-03-27T22:36:45+00:00

## Health v2 (maintenance only)
Score: 56/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 74, release rhythm 8, longevity 100
- inputs: {"age_days": 4537, "days_push": 159, "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 22575, forks 962 (observed 2026-08-28T04:11:32.748124+00:00)

## What it is
lowdb is a tiny, type-safe local JSON database for Node.js, Electron, and the browser. Data is stored as a plain JavaScript object in a JSON file, manipulated with native JavaScript, and persisted with safe atomic writes.

## Use cases
- store app settings in a json file
- simple local database for a small node app
- persist data in an electron app without a server
- embed a lightweight json datastore in a browser app
- save user data to db.json with typescript type safety
- swap a full database for a flat file in prototypes

## When to choose
- you need simple, dependency-light persistence for small datasets
- you want data as plain JavaScript objects with no query language
- you're building Electron, Node, or browser apps with local JSON storage
- you want hackable storage adapters (YAML, encryption, etc.)

## When to avoid
- you need concurrent writes from multiple processes or servers
- you need querying, indexing, or large datasets beyond memory
- you need relational or transactional guarantees

## Facets
- artifact type: library
- maturity: stable
- function: database, serialization, json, file-system
- domain: databases, developer-tools, web-development, files
- platform: browser, cross-platform
- tags: json-database, embedded-database, local-storage, typescript, esm, lightweight, flat-file, nodejs, electron, javascript

## Member repositories
- typicode/lowdb (main) score 56

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:11:32.748124+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-29T16:56:58.187528+00:00, confidence not recorded.
  - readme: https://github.com/typicode/lowdb (fetched 2026-08-28T04:11:32.748124+00:00, sha ae94adb879cc)
  - registry_npm: https://registry.npmjs.org/lowdb (fetched 2026-08-29T07:55:34.137694+00:00, sha 5466a01fe13a)
- Data as of 2026-08-30T08:39:29.467469+00:00.