The `jsonjsdb-builder` package, currently at version 0.6.11, is a development tool that transforms structured data, primarily from Excel (.xlsx) files and Markdown documents, into two JSON-based formats. It generates a compact `.json.js` file (an array of arrays) optimized for efficient, server-less loading in web browsers (e.g., via `file://`), and a standard `.json` file (an array of objects) for general tooling and readability. This package is part of the broader `jsonjsdb` ecosystem, including a Python component. Its release cadence is driven by bug fixes and developer experience improvements, such as recent patches to prevent unnecessary database rewrites during development. A key differentiator is its tight integration with front-end build systems like Vite, offering automated data regeneration and hot-reloading, which streamlines the development of applications leveraging local, structured data.
npm install jsonjsdb-builderVerified import paths — ran on the pinned version, not inferred.
This quickstart demonstrates how to initialize the `JsonjsdbBuilder` class, set up a temporary output directory for generated JSON files, and show where Excel source files would be specified for conversion. It illustrates the basic API usage for setting up the builder environment.
Ensure `vite-plugin-full-reload` is installed: `npm install -D vite-plugin-full-reload`.
Verify that the input directory (e.g., 'db' or 'markdown') contains the necessary source files before running builder commands.
Upgrade to `jsonjsdb-builder` version 0.6.11 or newer to benefit from optimizations that prevent redundant file rewrites when source content is identical.
Use the default import syntax: `import JsonjsdbBuilder from 'jsonjsdb-builder'`.
Use named import syntax: `import { initJsonjsdbBuilder } from 'jsonjsdb-builder'`.Ensure all directory paths provided to builder methods either exist or are accessible for creation by the builder process.
Convert your module to use ES Module syntax with `import` statements, or configure your environment to correctly handle ESM packages.
No dependency data recorded yet.