pixeldb

A tiny, embeddable key-value store for developers who don't want to think about databases.

PixelDB stores everything in a single file, supports atomic writes, and has zero runtime dependencies. Perfect for CLI tools, prototypes, and "I just need to remember a few things" use cases.

Install

npm install pixeldb

Usage

import { open } from "pixeldb";

const db = await open("./mydata.pxl");

await db.set("user:42", { name: "Ada", role: "admin" });
const ada = await db.get("user:42");

await db.delete("user:42");
await db.close();

Why PixelDB?

• Single-file — your whole database is one .pxl file you can cp or back up
• Atomic — every write is fsync'd; no half-written records on crash
• Tiny — under 600 lines of TypeScript, zero deps
• Fast enough — ~50k writes/sec on a modern laptop
• Boring — no servers, no clients, no protocols

Roadmap

• Basic get/set/delete
• Atomic writes
• TypeScript types
• Range scans
• Optional encryption
• Browser build (IndexedDB backend)

License

MIT