Docs
Demuddler is a data importer that you embed in your product. Your users open a file, match its columns to your fields and correct the values. The file stays in their browser. Your application gives the schema and decides where the finished rows go. To try it without code, open the demo.
npm install @demuddler/importer- InstallInstall the package, add your licence key and make your first import.
- SchemaDefine your fields, their types and the rules that check each value.
- Clean a fileOpen a file, match its columns, correct the values and export the rows.
- Deliver rowsRead the finished rows in batches and send them to your backend.
- FrameworksAdd the importer to React, Next.js, Vue, Svelte, Angular, Astro or plain JavaScript.
- LicensingCreate a licence key, register your domains and read the plan limits.
Integration path
Section titled “Integration path”- Create a licence, register your hostname and copy the licence key.
- Install the package and run the example in Install.
- Replace the example schema with your own schema.
- Read the finished rows in the
completeevent. See Deliver rows. - Send the rows to your backend. Your backend must check, store and commit them by the rules of your application.
- Before release, test invalid data, retries, row limits and your production Content Security Policy.
Product boundaries
Section titled “Product boundaries”| Question | Answer |
|---|---|
| Which files can I open? | CSV, TSV and Excel (.xlsx and .xls). JSON files and password-protected workbooks do not open. |
| Does Demuddler receive my file? | No. File bytes, file names, column names, values and sheet names stay in the browser. Your own code sends rows to your backend. See Deployment and privacy. |
| Does the package include the engine? | No. The package loads the hosted runtime, so the importer needs network access to start. |
| What does each plan limit? | See Plans and limits. |
| Do rule failures block the import? | No. Rows with problems stay visible, and the user chooses each exclusion. A required field with no column blocks completion. A selected value that does not convert stops the output. |
| Does the importer keep my file on refresh? | No. The importer does not keep the open file or its edits. A refresh starts again with no file. |
| Can browser checks replace backend checks? | No. Your backend must apply authentication, permissions and business rules. |