@lucentive-labs/loupe-generator

The Node-only Loupe static-HTML generator. generate() bundles a self-contained, deterministic index.html (JS + CSS inlined, referenced assets copied and URL-rewritten) that runs under file:// or any static host — the artifact at the heart of the screenshot-verify loop. No timestamps or absolute paths, so output is reproducible.

Install

Publishing to npm shortly. Until then, use Loupe from a clone of the workspace: https://github.com/LucentiveLabs/loupe

pnpm add @lucentive-labs/loupe-generator

Usage

import { generate } from "@lucentive-labs/loupe-generator";
import { config } from "./loupe.config";

await generate(config, { outDir: "dist", assetsDir: import.meta.dirname });
// → dist/index.html (+ dist/assets/* if the config references any)

generate() validates the config before emitting. Verify the artifact with a Playwright screenshot, then export the brief.

Sibling packages

• @lucentive-labs/loupe-schema — the Zod config contract + JSON Schema.
• @lucentive-labs/loupe-core — zero-dependency headless core (store, derivations, crop math).
• @lucentive-labs/loupe-dom — vanilla browser renderer + styles.css.
• @lucentive-labs/loupe-react — React 19 adapter (<Loupe />, useLoupe()).

Part of Loupe — full catalog & docs at https://labs.lucentive.io/libraries/loupe · source: github.com/LucentiveLabs/loupe

MIT © 2026 Lucentive Labs.