ViteHub

What is ViteHub about?

ViteHub delivers a collection of server primitives that can be composed via a single Vite plugin. It abstracts away host‑specific implementations, letting developers write routes once and run them on any supported platform (Cloudflare Workers, Vercel, Netlify, Deno, Node).

How to use ViteHub?

1. Install the core packages:

   npx npm@latest install vite-hub nitro h3
   npx npm@latest install -D vite
   

2. Configure the Vite plugin (choose a preset that matches your deployment target):

   // vite.config.ts
   import { vitehub } from "vite-hub";
   import { defineConfig } from "vite";
   
   export default defineConfig({
     plugins: [vitehub({ preset: "node", kv: true })]
   });
   

3. Create server routes under server/ using the H3 helper functions. Example KV read:

   // server/api/settings.get.ts
   import { defineEventHandler } from "h3";
   import { kv } from "vite-hub/kv";
   
   export default defineEventHandler(async () => {
     const [error, settings] = await kv.get("settings");
     if (error) throw error;
     return settings;
   });
   

4. Build & deploy with Nitro; the same code works on all supported hosts.

Key features of ViteHub

• Unified API for all primitives (KV, Blob, Database, Queue, Workflow, Auth, etc.).
• Agent primitive to run portable automation that can interact with any other primitive.
• One‑click deployment to Cloudflare Workers, Vercel, Netlify, Deno, or plain Node.
• Typed configuration via the Env primitive.
• Built‑in logging, rate limiting, realtime collaboration, sandboxed execution, and AI gateway routing.
• Presets (cloudflare, vercel, netlify, deno, node) simplify host‑specific setup.
• Active development with Apache‑2.0 license and clear production‑ready guidance.

Use cases of ViteHub

• Full‑stack Vite apps needing server‑side storage, background jobs, and authentication without writing host‑specific code.
• AI agents that read/write KV, trigger workflows, or send emails, all orchestrated from the same project.
• Serverless APIs for static sites hosted on Netlify or Vercel, leveraging the same codebase.
• Rapid prototyping of CRUD services, content management, or real‑time collaboration tools.
• Cross‑platform tooling where the same business logic runs locally, in CI, and in production across multiple clouds.

FAQ from ViteHub

• Do I need an account with a specific cloud provider? No. ViteHub works offline; you only need credentials for the chosen host when you actually deploy.
• Can I use only a subset of primitives? Yes. Import and configure only the primitives you need.
• What Node version is required? Node.js 22.22 or newer.
• Is ViteHub stable? It is actively developed (pre‑1.0). Pin versions for production and follow the "Prepare a production deployment" guide.
• How do I add a coding‑agent skill? Run npx skills add https://vitehub.dev --skill vitehub.
• Where can I find documentation? https://vitehub.dev and the in‑repo docs/ folder.

Server Primitives

Use each primitive alone, or use them together in one app.

Write once, deploy anywhere

// server/api/settings.get.ts
import { defineEventHandler } from "h3";
import { kv } from "vite-hub/kv";

export default defineEventHandler(async () => {
  const [error, settings] = await kv.get("settings");
  if (error) throw error;
  return settings;
});

This route does not change between hosts. The host selects the provider:

Host	KV	Blob	Database
Cloudflare	Workers KV	R2	D1
Vercel	Upstash Redis	Vercel Blob	libSQL or D1 HTTP
Netlify	Upstash Redis	Netlify Blobs	libSQL
Deno	Deno KV	S3-compatible	libSQL
Node	fs-lite or Upstash	fs or S3-compatible	SQLite or libSQL

Support is different for each primitive. Read the support matrix before you select a host.

Get started

pnpm add vite-hub nitro h3
pnpm add -D vite

If pnpm stops with ERR_PNPM_IGNORED_BUILDS and names esbuild, the packages from that command are installed. Run pnpm approve-builds esbuild one time to let esbuild run its install script. Then run pnpm add -D vite before you continue.

// vite.config.ts
import { vitehub } from "vite-hub";
import { defineConfig } from "vite";

export default defineConfig({
  plugins: [vitehub({ preset: "node", kv: true })],
});

Nitro serves the routes in server/ and builds the output for your host. For a complete app, follow the First Server Primitive tutorial. It runs offline and needs no account.

If a coding agent writes your app, install the ViteHub skill:

npx skills add https://vitehub.dev --skill vitehub

Requirements: Node.js 22.22 or newer and Vite 8 or newer. Presets: cloudflare, netlify, vercel, deno, and node.

Agents

Agents are one more primitive. Their Capabilities wrap the same primitives that your routes call, so a route can read the KV store that an Agent writes. Start with the First Agent tutorial.

Status

ViteHub is in active development and has not reached 1.0. Interfaces can change between 0.x releases, and security fixes land on main only. Pin your versions, and read Prepare a production deployment before you serve traffic.

Contributing

See AGENTS.md for the code map and checks. ViteHub uses the Apache License 2.0. Report vulnerabilities through the security policy.