vite-plugin-react-router-xray

Vite plugin for startup route analysis, dev instrumentation, and virtual manifest output.

Install

npm install -D vite-plugin-react-router-xray react-router-xray-core

Usage

import { defineConfig } from "vite";
import react from "@vitejs/plugin-react";
import reactRouterXray from "vite-plugin-react-router-xray";

export default defineConfig({
  plugins: [
    react(),
    reactRouterXray({
      routes: ["/", "/about", "/settings"],
      failOnBuild: false,
      startupAnalysis: true
    })
  ]
});

The plugin accepts routes as an array or newline-delimited string and normalizes input before analysis. Startup logging runs in a microtask after Vite resolves config so the dev server can finish its synchronous startup path first. Set startupAnalysis: false to skip that work entirely.

Virtual module

import manifest from "virtual:react-router-xray/manifest";

Use the virtual manifest to read analyzed routes and aggregate analysis stats inside dev tooling.

License

MIT