vibe-builder-engine

Browser-only bundling engine powering Vibe Builder.

Stack: esbuild-wasm (compile) · in-memory virtual FS · esm.sh CDN (npm deps) · sandboxed iframe preview

Install

npm install vibe-builder-engine

Usage

import {
  loadProject,
  initBundler, bundle,
  mountPreview, updatePreview, showError,
} from "vibe-builder-engine";

// 1. Load project files into the virtual FS
await loadProject(files);

// 2. Initialise esbuild-wasm (once)
await initBundler();

// 3. Bundle and preview
const result = await bundle();
const iframe = document.getElementById("preview");
mountPreview(iframe);
updatePreview(result.outputFiles[0].text);

Exports

Default (@vibe-builder/engine)

| Export | Description | |---|---| | loadProject(files) | Write a project's files into the virtual FS | | initBundler() | Bootstrap esbuild-wasm | | bundle() | Bundle the project entry point | | mountPreview(iframe) | Attach the sandbox iframe | | updatePreview(js) | Inject new bundle into the iframe | | showError(msg) | Display an error in the preview iframe |

Sub-path exports

| Import path | Exported symbols | |---|---| | vibe-builder-engine/filesystem | resetFS writeFile readFile fileExists deleteFile listFiles fileCount snapshot restoreSnapshot loadProject getEntryPoint getFramework | | vibe-builder-engine/bundler | initBundler bundle | | vibe-builder-engine/resolver | esmResolverPlugin clearCDNCache | | vibe-builder-engine/preview | mountPreview updatePreview showError destroyPreview | | vibe-builder-engine/publisher | generateZip |

License

MIT