HelloCSV

A Sleek CSV Importer
GitHub
580
Created 4 years ago, last commit 2 days ago
7 contributors
445 commits
Stars added on GitHub, per day, on average
Yesterday
=
Last week
+4.4
/day
README

Logo

HelloCSV

A modern, drop in, frontend only, CSV importer workflow.

Explore the docs »

View Demo . Report Bug . Request Feature

NPM JavaScript Style Guide Build Status License

About The Project

Screenshot

A challenge almost every project eventually faces is importing user uploaded data from CSV files in a way that doesn't cause a ton of issues. Developers always have to figure out

  • How do you make sure that data uploaded is correct
  • How do you notify the user that the data is incorrect before they upload it, and give the user a chance to fix it
  • Incorrect or duplicate data that is uploaded is super annoying to try to fix after-the-fact
  • Run automatic formatters (ex: phone number formatting), but providing a way for the user to see what our formatter did before uploading as a sanity check

HelloCSV a Javascript library that drops in a CSV importer into your project that:

  • Supports custom columns
  • with custom validations
  • and custom transformations
  • a nice UI that walks a user through a 4 step process of uploading a CSV (upload, map columns, preview data, upload confirmation)
  • with a small JS footprint
  • that doesn't assume your frontend stack

Install

With npm:

npm install hello-csv

From CDN

<script src="https://cdn.jsdelivr.net/npm/hello-csv@0.3.1/dist/bundled/index.es.js"></script>
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/hello-csv@0.3.1/dist/bundled/hello-csv.css">

Documentation

Current documentation could be find here