First server primitive

KV is the fastest first server primitive because it stores small values by key and does not require a Definition file.

Install KV

pnpm add @vite-hub/kv

Register the KV integration.

import { hubKv } from '@vite-hub/kv/vite'
import { defineConfig } from 'vite'

export default defineConfig({
  plugins: [hubKv()],
})

Local development uses a local store by default. Add host configuration later when you deploy.

Write a value

Create a server route that writes a small JSON-like value.

import { kv } from '@vite-hub/kv'

export default defineEventHandler(async (event) => {
  await kv.set('settings', await readBody(event))
  return { ok: true }
})

Read the value

Read from the same Runtime Helper in any server route.

import { kv } from '@vite-hub/kv'

export default defineEventHandler(async () => {
  return {
    settings: await kv.get('settings'),
  }
})

The route imports kv from @vite-hub/kv. It does not import a Cloudflare, Vercel, or local driver directly.

Continue with the full KV page

The full KV page covers prefixes, host storage, and using KV from an Agent Capability.

Use Database instead when the data needs relationships, constraints, joins, migrations, or history.