# electron-userland/electron-json-storage

:package: Easily write and read user settings in Electron apps

Repository: https://github.com/electron-userland/electron-json-storage
Canonical: https://ross.abutalabs.com/products/electron-json-storage
Language: JavaScript
License Family: other
Topics: electron, json, settings, storage
Last push: 2023-06-12T15:26:15+00:00

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

## Adoption (not part of the score)
Stars 1425, forks 75 (observed 2026-08-28T04:04:41.472943+00:00)

## What it is
A Node.js library for Electron apps that provides a localStorage-like API to persist and read JSON objects as user settings in the OS application data directory. It works from both main and renderer processes and supports sync and async operations.

## Use cases
- persist user settings in an electron app
- save app preferences as  files
- read and write config data in electron main process
- store key-value  data in userData directory
- replace localStorage with file-based storage in electron
- load settings synchronously in electron renderer

## When to choose
- you need a simple localStorage-like JSON persistence layer for Electron
- you want settings stored in the OS userData directory
- you need sync and async read/write APIs

## When to avoid
- you need structured or encrypted storage
- you prefer a maintained alternative like electron-store
- you need storage beyond simple JSON key-value files

## Facets
- artifact type: library
- maturity: maintenance
- function: file-system, configuration-management
- domain: desktop-applications, developer-tools, files
- platform: cross-platform
- tags: electron, user-settings, -storage, localstorage-like, nodejs, javascript

## Member repositories
- electron-userland/electron-json-storage (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:41.472943+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-30T04:37:30.635185+00:00, confidence not recorded.
  - readme: https://github.com/electron-userland/electron-json-storage (fetched 2026-08-28T04:04:41.472943+00:00, sha c12a54ac5acb)
  - registry_npm: https://registry.npmjs.org/electron-json-storage (fetched 2026-08-29T11:49:36.524049+00:00, sha 73eb75014a45)
- Data as of 2026-08-30T08:39:29.467469+00:00.