XLSX

Generate native Excel .xlsx workbooks from JSON and TypeScript.

Install

npm install @runstamp/xlsx

Requires Node.js >=18.

Quick Start

import { SpreadsheetEngine } from "@runstamp/xlsx";
import { writeFileSync } from "node:fs";

const buffer = await SpreadsheetEngine.render({
  meta: { title: "Revenue Report", creator: "Runstamp" },
  sheets: [
    {
      name: "Revenue",
      rows: [
        { cells: [{ value: "Quarter" }, { value: "Revenue" }] },
        { cells: [{ value: "Q1 2026" }, { value: 420000 }] },
        { cells: [{ value: "Q2 2026" }, { value: 465000 }] },
      ],
    },
  ],
});

writeFileSync("revenue.xlsx", buffer);

Core API

• SpreadsheetEngine.render(document, options?) — returns a Uint8Array of the .xlsx file.
• SpreadsheetEngine.validateDocument(document) — validate against the Zod schema.
• SpreadsheetEngine.renderValidated(validatedDocument, options?) — render a pre-validated document.
• preflightSpreadsheet(document) — run checks before rendering.
• FormulaEvaluator, F — build and evaluate formulas.

Supports multiple sheets, cell styles, merges, filters, formulas, hyperlinks, and print setup. Output is deterministic.

Hosted and commercial plans

Repair, quality reporting, formula evaluation, and template assembly ship in @runstamp/xlsx. Pro and higher plans add managed execution, durable delivery, governance, support, and commercial service terms; there is no separate XLSX npm engine to install. See License & Pricing.