Registry / devops / vite-plugin-import-graph

vite-plugin-import-graph

library0.0.1jsnpmunverified

A Vite plugin that records a project's module import graph as a JSON file. Version 0.0.1 is the initial stable release. It focuses purely on data output without a visualization frontend, making it faster than integrated tools. It supports options like absolute/relative module IDs and prefixing virtual/npm modules. Output is a JSON object mapping module IDs to arrays of imported IDs, with npm package paths merged at the package level. The plugin is lightweight and designed for downstream use with visualization (D3.js, Graphviz) or analysis (circular dependencies, dead code, test impact).

devops data

npm install vite-plugin-import-graph

github ↗package ↗

INSTALL

IMPORT

SIG · VITE-PLUGIN-IMPORT

vite-plugin-import-graph

devopsjavascriptv0.0.1

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.

importGraph (default export)

✓ import importGraph from 'vite-plugin-import-graph'

✗ import { importGraph } from 'vite-plugin-import-graph'

The package exports a default function. Do not use named import.

ImportGraphOptions (type)

✓ import type { ImportGraphOptions } from 'vite-plugin-import-graph'

TypeScript types are exported; use `import type` for compile-time only.

CommonJS require

✓ const importGraph = require('vite-plugin-import-graph')

✗ const { importGraph } = require('vite-plugin-import-graph')

CommonJS require works but only as default import, not destructured.

Configure the plugin with default options to generate import graph JSON.

// vite.config.ts import { defineConfig } from 'vite'; import importGraph from 'vite-plugin-import-graph'; export default defineConfig({ plugins: [ importGraph({ filename: 'import-graph.json', absoluteModuleIds: false, usePrefix: false, }) ] });

Debug

Known issues

gotchaOutput file is written relative to project root, not cwd.

fix

Specify an absolute path for `filename` if needed.

affects: >=0.0.0

gotchaNpm package paths are merged at the package level; individual file paths within a package are not recorded.

fix

Use `absoluteModuleIds: true` with custom resolution if you need per-file granularity.

affects: >=0.0.0

gotchausePrefix only adds prefixes to virtual modules and npm packages; other module IDs remain unchanged.

fix

Enable `usePrefix` only if you need to distinguish virtual/npm modules.

affects: >=0.0.0

Errors

Common errors & fixes

Cannot find module 'vite-plugin-import-graph'

Package not installed or not running in Vite context.

fix

Run `npm i -D vite-plugin-import-graph` and ensure Vite dev/build is executed in the same project.

TypeError: importGraph is not a function

Using named import instead of default import.

fix

Change to `import importGraph from 'vite-plugin-import-graph'`.

Error: [vite-plugin-import-graph] Vite >= 5 required

Installed Vite version is older than 5.

fix

Upgrade Vite to ^5.0.0: `npm i vite@^5.0.0 -D`.

Upgrade

Version history

0.0.1latest on npm

Audit

Dependencies

viterequiredPeer dependency; plugin requires Vite 5+ to function.

Agent activity

24 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/Justineo/vite-plugin-import-graph ↗

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