Web

Vite can serve and build a browser application that uses @jolly-pixel/runtime without runtime-specific plugins.

Configure Vite

A minimal configuration is enough:

import { defineConfig } from "vite";

export default defineConfig({});

Keep the asset catalog and files that must retain their names in public/:

public/
├── assets.json
└── models/
    └── hero.glb

Vite serves these files from the application root during development and copies them unchanged to the build output.

const runtime = await Runtime.create("canvas", {
  assets: {
    catalog: new URL("assets.json", document.baseURI)
  }
});

Use the usual Vite scripts to run and build the application:

{
  "scripts": {
    "dev": "vite",
    "build": "vite build",
    "preview": "vite preview"
  }
}

$ pnpm run dev
$ pnpm run build

Optional source plugins

The runtime does not require the following plugins. Add them when the project imports the corresponding source format:

• vite-plugin-glsl imports GLSL and WGSL files.
• vite-plugin-wasm supports WebAssembly ESM integration and wasm-pack output.
• vite-plugin-checker runs TypeScript and lint checks alongside the development server.

Frame caps and the optional runtime HUD are covered in frame scheduling and performance.