Skip to content
demuddler

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
Coming soon
  1. Create a licence, register your hostname and copy the licence key.
  2. Install the package and run the example in Install.
  3. Replace the example schema with your own schema.
  4. Read the finished rows in the complete event. See Deliver rows.
  5. Send the rows to your backend. Your backend must check, store and commit them by the rules of your application.
  6. Before release, test invalid data, retries, row limits and your production Content Security Policy.
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.