# tableflowhq/csv-import

The open-source CSV importer, maintained by @tableflowhq

Repository: https://github.com/tableflowhq/csv-import
Canonical: https://ross.abutalabs.com/products/csv-import
Homepage: https://tableflow.com
Language: TypeScript
License: MIT
License Family: permissive
Topics: file-sharing, file-upload, import, importer, react, typescript, upload, uploader, csv, excel
Last push: 2025-10-21T18:38:31+00:00

## Health v2 (maintenance only)
Score: 52/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 48, release rhythm 35, longevity 93
- inputs: {"age_days": 1311, "days_push": 316, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1790, forks 127 (observed 2026-08-28T04:05:36.976324+00:00)

## What it is
An open-source CSV, TSV, and XLS/XLSX file importer embeddable in web apps via React or JavaScript SDKs. Users upload spreadsheets through a modal, map columns to a defined template, and the app receives clean structured data via an onComplete callback.

## Use cases
- import csv files into my react app
- let users upload spreadsheets with column mapping
- embed a csv importer widget in my web application
- parse xlsx uploads and return structured json
- build a data onboarding flow for customer spreadsheets
- validate and map imported spreadsheet columns to my schema

## When to choose
- you need a polished, embeddable spreadsheet import experience in React or vanilla JS
- you want template-driven column mapping and validation without building it yourself
- you prefer an MIT-licensed self-hostable alternative to commercial importers

## When to avoid
- you need AI-based extraction from PDFs or scanned documents rather than structured spreadsheets
- your app is not web-based (e.g., mobile-native or CLI)
- you only need simple server-side CSV parsing with no user-facing UI

## Facets
- artifact type: library
- maturity: active
- function: file-upload, parser, ui-components, csv
- domain: web-development, frontend, files
- platform: -
- tags: csv-importer, spreadsheet-import, data-onboarding, excel, react-component, modal, column-mapping, data-engineering, react, typescript, javascript, web, nodejs

## Member repositories
- tableflowhq/csv-import (main) score 52

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:36.976324+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:23:17.710262+00:00, confidence not recorded.
  - readme: https://github.com/tableflowhq/csv-import (fetched 2026-08-28T04:05:36.976324+00:00, sha 2b6066dbead7)
  - homepage: https://tableflow.com (fetched 2026-08-29T11:02:31.067766+00:00, sha 007be82adba1)
  - site_page: https://tableflow.com/product/features (fetched 2026-08-29T11:02:31.076906+00:00, sha 703928857354)
  - site_page: https://docs.tableflow.com (fetched 2026-08-29T11:02:31.078704+00:00, sha 9cbfb5c2f89f)
  - site_page: https://tableflow.com/about (fetched 2026-08-29T11:02:31.080313+00:00, sha 6417b6fdfece)
- Data as of 2026-08-30T08:39:29.467469+00:00.