Universal, Zero-Config Key-Value Store for Node.js, Browser, and React Native.

PolyKV for TypeScript automates persistence across the entire JavaScript ecosystem. Whether you are building a CLI, a Web App, or a Mobile App, the API remains exactly the same.

One API, Everywhere. This library is part of the PolyKV ecosystem. Use the same consistent API across 12+ languages.

• 🦄 Universal API Write code once. It runs on Node.js (fs), Browser (localStorage), and React Native (AsyncStorage) without changes.

• 🔄 Polymorphic Storage Detects the environment at runtime and selects the best native storage driver automatically.

• 📱 React Native Ready Seamlessly integrates with @react-native-async-storage/async-storage. No extra bridging code needed.

npm install polykv
# or
pnpm add polykv
# or
yarn add polykv

import { PolyKV } from 'polykv';

const db = new PolyKV("UserPrefs");

// 1. Save (Set)
await db.setString("theme", "dark");
await db.setNumber("fontSize", 14);
await db.setBool("notifications", true);
await db.setMap("user", { id: 1, name: "Alice" });

// 2. Read (Get)
const theme = await db.getString("theme");
console.log(`Theme: ${theme}`); // "dark"

// 3. Update
await db.setNumber("fontSize", 16); // Overwrites previous value

// 4. Delete (Remove)
await db.remove("theme");
const check = await db.getString("theme");
console.log(check); // null

// 5. Clear All
await db.clear(); // Wipes everything in "UserPrefs"

• Node.js: Creates JSON files in ~/.config or %APPDATA%.
• Browser: Persists to localStorage with namespaced keys.
• React Native: Bridges efficiently to native mobile storage.

✅ Runtime Verified: Full CRUD operations verified via automated tests on actual devices/simulators.

MIT