📘 Documentation website powered by GitBook (previous project docs were pulled from web archive)
This lib allows you to build and write an Excel file dynamically, it does not include any reader capabilities making the library super lightweight.
Visit the Live demo to get started and see all available options and methods that the library offers.
You can also take a look at the "Used by" section below to see real world applications taking advantage of this library.
Excel-Builder-Vanilla is a fork of the popular excel-builder.js project (thanks to @stephenliberty for this great library). The main goal in creating this fork was to modernize the project by removing dependencies that are no longer necessary and replace JSZip by fflate which provides an ESM build giving us Tree Shaking. The other goal was also to provide an ESM bundle to slowly get away from CommonJS (CJS bundle is still offered but we strongly suggest you migrate to the ESM approach)
The modernization steps:
- migrate to TypeScript (giving us TS Types
d.ts) - drop
Qdependency (we simply use nativePromise) - drop
Lodashdependency (we now use native JS code) - replace
JSZipdependency withfflatewhich has an ESM build and offers better performance. - bump version to
v3.0.0as amajorrelease (the original project version was in the2.xrange.)- note that the changelog did not exists prior to
v3.0.0
- note that the changelog did not exists prior to
The project now requires only 1 dependency which is fflate.
This modernization is providing a huge decrease in the final build size, with now only 1 dependency, and is offering better performance 🚀
npm install excel-builder-vanillaThe project offers 3 different bundle types, choose the best one depending on your use case
- ESM: to
import from(preferred) - CJS: CommonJS to support old NodeJS
require()- will probably be removed in the future - IIFE: standalone script with
ExcelBuilderavailable on thewindowobject
// ESM (preferred) - npm install
import { createWorksheet } from 'excel-builder-vanilla';
// CJS - npm install
const { createWorksheet } = require('excel-builder-vanilla');
// IIFE - CDN
<script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/excel-builder.iife.js"></script>
<script>
const worksheet = ExcelBuilder.createWorksheet(); // or window.ExcelBuilder.createWorksheet();
</script>Please note that since we use fflate (which creates and compresses the Excel file before sending it to the browser), you might get some CSP errors because of its use of Web Workers. For that reason, you might need to adjust your CSP rules by adding worker-src 'self' blob:;
<meta http-equiv="Content-Security-Policy"
content="default-src 'self';
// other rules...
worker-src 'self' blob:;" />This fork was created mostly to support Tree Shaking (ESM), get away from CJS, provide TS Types and update all project dependencies. It is used by a few other Open Source libraries that I also maintain and requires Excel export:
Pull Request are welcome, feel free to contribute.
If you wish to contribute to the project, please follow these steps:
Note: this project uses pnpm workspaces, you can install pnpm by following their installation or use NodeJS corepack enable to run any of the pnpm scripts shown below:
- clone the lib:
git clone https://github.com/ghiscoding/excel-builder-vanilla
- install it with pnpm from the project root:
pnpm installORnpx pnpm install
- run a full TypeScript build
pnpm run buildORnpx pnpm run build
- run in development mode (lib & demo)
pnpm run devORnpx pnpm run dev
Before submitting a PR (pull request), please make sure that you followed these steps for a better chance of a successfull PR:
- make sure that you have already executed
pnpm install - run the Biome lint npm script (or simply use step 4)
pnpm run biome:lint:write
- run the Biome code formatting npm script (or simply use step 4)
pnpm run biome:format:write
- run a full Build (this will also run Biome lint/format, so you could skip step 2)
pnpm run build
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent