@vite-hub/kv

@vite-hub/kv gives server code one small-state API for settings, flags, cache entries, and JSON-like records.

Install

pnpm add @vite-hub/kv

Add @upstash/redis when you use the Upstash driver.

Minimal API

// server/api/settings.put.ts
import { kv } from "@vite-hub/kv"
import { defineEventHandler, readBody } from "h3"

export default defineEventHandler(async (event) => {
  await kv.set("settings", await readBody(event))

  return kv.get("settings")
})

// nitro.config.ts
import { defineNitroConfig } from "nitro/config"

export default defineNitroConfig({
  modules: ["@vite-hub/kv/nitro"],
  kv: {
    driver: "fs-lite",
    base: ".data/kv",
  },
})

Vite and Nitro

Use hubKv() in Vite or @vite-hub/kv/nitro in Nitro. Both resolve the same kv config and expose the same kv runtime helper.

Providers include local fs-lite, Cloudflare Workers KV, and Upstash Redis. The storage layer is built on unstorage.

Learn more at vitehub.dev.