@freereportjs/core
v0.13.1
Published
FreeReport — a web reporting engine (free for personal use): banded report designer, paged viewer, printing, PDF with embedded Korean fonts, Excel export.
Maintainers
Readme
FreeReport
A web reporting tool that runs in the browser: a banded report designer, a paged viewer, exact printing, PDF with embedded Korean fonts, Excel (as printed or as data), HWPX (한/글), watermarks and web embossing, barcodes (Code128, EAN-13, QR, DataMatrix, PDF417), charts, crosstabs and label sheets. No plugin, ActiveX or print module.
Free for personal use. Companies need a domain license — ₩500,000 per domain per year or ₩900,000 perpetual. See freereport.app/pricing.
- Website, demos and docs: https://freereport.app
- 한국어: https://freereport.app/ko/
Install
npm i @freereportjs/coreFramework components: @freereportjs/react, @freereportjs/vue, @freereportjs/svelte,
@freereportjs/angular. Script tag: https://freereport.app/cdn/latest/freereport.min.js (global FreeReport).
Viewer
import { createViewer } from '@freereportjs/core';
import '@freereportjs/core/styles.css';
const definition = {
name: '매출 보고서',
page: { size: 'A4', margins: 15 },
bands: {
title: { height: 14, elements: [{ type: 'text', x: 0, y: 0, w: 180, h: 12, text: '매출 보고서', style: { fontSize: 16, bold: true, align: 'center' } }] },
detail: { height: 6, elements: [
{ type: 'field', x: 0, y: 0, w: 120, h: 6, expr: 'product', style: { border: true } },
{ type: 'field', x: 120, y: 0, w: 60, h: 6, expr: 'qty * price', format: '#,##0', style: { border: true, align: 'right' } },
] },
summary: { height: 8, elements: [{ type: 'text', x: 0, y: 1, w: 180, h: 7, text: '합계 {sum(qty * price):#,##0}원', style: { align: 'right', bold: true } }] },
pageFooter: { height: 8, elements: [{ type: 'text', x: 0, y: 1, w: 180, h: 6, text: '{page} / {pages}', style: { align: 'center' } }] },
},
};
createViewer(document.getElementById('report')!, {
definition,
data: { rows: [{ product: '노트북', qty: 2, price: 1290000 }] },
onOutput: e => console.log('output log', e), // return false to cancel a print or download
});Designer
import { createDesigner } from '@freereportjs/core';
createDesigner(document.getElementById('designer')!, {
definition, data,
onChange: def => save(def), // the report definition is plain JSON
});Without the viewer
import { createReport } from '@freereportjs/core';
const report = createReport(definition, data, { pdfSecurity: { userPassword: '1234', permissions: { copy: false } } });
await report.ready();
const pdf = await report.toPdf(); // Blob
const xlsx = await report.toXlsx('form'); // or 'data'
await report.print();Server side (Node, Deno, Bun): renderPdf(definition, data, { fonts }) and renderXlsx(...).
License key
import { setLicenseKey } from '@freereportjs/core';
setLicenseKey('FR1....');Without a key on a public domain the library prints a notice to the browser console once; nothing else changes. See LICENSE.
© 2026 (주)세컨드코리아 · [email protected]
