@forinda/kickjs-vite

Vite plugin for KickJS — single-port dev server, HMR, virtual modules, and http.Server piping for adapters (WebSocket, GraphQL subscriptions, etc.).

Install

pnpm add -D @forinda/kickjs-vite vite unplugin-swc

Quick Example

// vite.config.ts
import { defineConfig } from 'vite'
import swc from 'unplugin-swc'
import { kickjsVitePlugin, envWatchPlugin } from '@forinda/kickjs-vite'

export default defineConfig({
  oxc: false,
  plugins: [swc.vite(), kickjsVitePlugin({ entry: 'src/index.ts' }), envWatchPlugin()],
  build: { target: 'node20', ssr: true, outDir: 'dist' },
})

// src/index.ts
import 'reflect-metadata'
import { bootstrap } from '@forinda/kickjs'
import { modules } from './modules'

export const app = await bootstrap({ modules })

The plugin reads the exported app from the entry file and serves it on Vite's HTTP server, one port for Vite assets and the KickJS API, whichever engine the app runs on, with HMR-aware reloads. envWatchPlugin() triggers a full reload when .env changes so config tweaks land without a manual restart.

Documentation

kickjs.app/guide/hmr

License

MIT