@wolfstar/vite-server

npm install @wolfstar/vite-server vite

pnpm add @wolfstar/vite-server vite

yarn add @wolfstar/vite-server vite

bun add @wolfstar/vite-server vite

npm

Source

Description

@wolfstar/vite-server is the Vite build and watch integration for Stars projects. The stars CLI loads it on demand when build.tool resolves to 'vite', so existing stars.config options and CLI commands are unchanged. Install vite in the consuming project; the integration uses the project’s own versions and Vite configuration.

When to use it

Enable the integration through stars.config.ts — the CLI handles loading and lifecycle for you:

import { defineConfig } from '@wolfstar/http-framework/config';

export default defineConfig({
	build: { tool: 'vite' },
	experimental: {
		enableVite: true
	}
});

Depend on this package directly only when you are embedding the builder into your own tooling. In every other case the CLI resolves and loads it for you.

Programmatic usage

The package exports ViteBuilder. Pass a resolved StarsConfig and a BuilderContext from @wolfstar/schema:

import { ViteBuilder } from '@wolfstar/vite-server';
import type { BuilderContext, ResolvedStarsConfig } from '@wolfstar/schema';

export async function build(config: ResolvedStarsConfig, context: BuilderContext) {
	const builder = new ViteBuilder(config, context);
	try {
		return await builder.build();
	} finally {
		await builder.close();
	}
}

The host supplies importFromProject (project-relative dependency loading with diagnostics) and pluginRegistrations (the entry transform that activates installed plugins). Since 0.2.2, pluginRegistrations only injects <name>/register for @wolfstar/plugin-* dependencies whose exports map defines ./register, so library plugins such as @wolfstar/plugin-cache no longer fail with ERR_PACKAGE_PATH_NOT_EXPORTED. This explicit boundary keeps the integration independent of the CLI and framework runtimes. watch() and close() implement the shared builder lifecycle. start, success, failure, and log events expose build status. Vite builds the application and uses its build watcher for rebuilds. Process supervision remains the responsibility of the host CLI.

Infrastructure

Shared pieces

Platform helpers

Plugins

npm

Source

Description

When to use it

Programmatic usage

npm

Source

​Description

​When to use it

​Programmatic usage

Description

When to use it

Programmatic usage