Registry / data / vite-plugin-csv

vite-plugin-csv

library1.0.0jsnpmunverified

A Vite plugin that enables importing CSV files directly into JavaScript/TypeScript code, returning parsed JSON arrays. Version 1.0.0 stable. It works with Vite 2.x and above, supports any framework (React, Vue, Svelte, etc.), and ships TypeScript declarations. Unlike manual CSV parsing, it integrates seamlessly with Vite's import system and hot module replacement.

data serialization

npm install vite-plugin-csv

github ↗package ↗

INSTALL

IMPORT

SIG · VITE-PLUGIN-CSV

vite-plugin-csv

datajavascriptv1.0.0

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–223 runs

build_error

glibc

node 18–223 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

default

✓ import CSV from 'vite-plugin-csv'

✗ const CSV = require('vite-plugin-csv')

ESM import required; CommonJS require will fail.

CSV

✓ import CSV from 'vite-plugin-csv'

✗ import { CSV } from 'vite-plugin-csv'

The package exports a default function, not a named export.

*.csv

✓ import data from './data.csv'

✗ import { data } from './data.csv'

Returns an array of objects (rows). No named exports from CSV files.

Shows how to install, configure the plugin in vite.config.js, and import a CSV file.

// vite.config.js import { defineConfig } from 'vite'; import CSV from 'vite-plugin-csv'; export default defineConfig({ plugins: [CSV()] }); // any .js/.ts file import data from './data.csv'; console.log(data); // [{"col1": "val1"}, ...]

Debug

Known issues

gotchaWithout a TypeScript shim, importing a .csv file in a .ts file will cause a type error.

fix

Add a declaration file with `declare module '*.csv' {}` to your project.

affects: >=0.0.0

gotchaPlugin only works with Vite v2 and above. Older versions not supported.

fix

Upgrade Vite to ^2.0.0 or later.

affects: >=0.0.0

gotchaThe CSV is parsed synchronously at build time. Large CSV files may impact build performance.

fix

Consider splitting large CSVs or using a runtime parser for dynamic data.

affects: >=0.0.0

gotchaImported CSV data is bundled into the output, so sensitive information may be exposed.

fix

Do not import CSV files with sensitive data; load them via fetch at runtime instead.

affects: >=0.0.0

Errors

Common errors & fixes

Cannot find module './data.csv' or its corresponding type declarations.

TypeScript cannot resolve .csv imports without a module declaration.

fix

Create a .d.ts file with `declare module '*.csv' { const data: any; export default data; }`

Uncaught TypeError: CSV is not a function

Plugin was imported using named import instead of default import.

fix

Use `import CSV from 'vite-plugin-csv'` instead of `import { CSV } from 'vite-plugin-csv'`.

Upgrade

Version history

1.0.0latest on npm

Audit

Dependencies

viterequiredpeer dependency to function as a Vite plugin

Agent activity

23 hits · last 30 days

node

Bingbot

OpenAI (training)

Resources

githubhttps://github.com/SirwanAfifi/vite-plugin-csv ↗

packagehttps://www.npmjs.com/package/vite-plugin-csv ↗