ViteHub
ViteHub is still experimental. Expect bugs and breaking changes.

First Server Primitive

Add local KV to a small Vite server and return one stored value.

This quickstart adds a local KV store to a small H3 server. One request writes a value, reads it back, and returns the result.

You need Node.js 24.15 or newer and pnpm. The first result runs locally without an account or credential.

Install KV

Create an empty project and install ViteHub with Vite and H3.

Terminal
mkdir vitehub-kv-start
cd vitehub-kv-start
pnpm init
pnpm pkg set type=module
pnpm add vite-hub h3 vite

Configure the Vite Integration

Register vitehub() and select the file-backed local KV driver. The explicit configuration stores values under .vitehub/data/kv.

vite.config.ts
import { resolve } from "node:path"

import { defineConfig } from "vite"
import { vitehub } from "vite-hub"

export default defineConfig({
  root: import.meta.dirname,
  appType: "custom",
  build: {
    outDir: "dist",
    rollupOptions: {
      input: resolve(import.meta.dirname, "src/server.ts"),
      output: { entryFileNames: "server.js" },
    },
    ssr: true,
  },
  plugins: [
    vitehub({
      preset: "node",
      blob: false,
      env: false,
      kv: { driver: "fs-lite", base: ".vitehub/data/kv" },
    }),
  ],
})

Write and read one value

Create one H3 route and use kv to write and read the setting.

src/server.ts
import { createServer } from "node:http"

import { H3, readBody } from "h3"
import { toNodeHandler } from "h3/node"
import { kv } from "vite-hub/kv"

const app = new H3().post("/settings", async (event) => {
  const settings = await readBody<{ theme: string }>(event)

  const [writeError] = await kv.set("settings", settings)
  if (writeError) throw writeError

  const [readError, storedSettings] = await kv.get("settings")
  if (readError) throw readError
  return { settings: storedSettings }
})

const port = Number(process.env.PORT || 5173)

createServer(toNodeHandler(app)).listen(port, () => {
  console.log(`ViteHub KV tutorial listening on http://localhost:${port}`)
})

Run the server

Build and start the generated Node.js entry.

Terminal
pnpm vite build
node dist/server.js

Send a value from another terminal.

Terminal
curl -X POST http://localhost:5173/settings \
  -H 'content-type: application/json' \
  -d '{"theme":"system"}'

The response proves that the route wrote and read through ViteHub:

Response
{"settings":{"theme":"system"}}

To move to a hosted store, change the provider in vite.config.ts. The server route keeps importing kv from vite-hub/kv.

Next steps