Introduction

Pure Index is a tool for packages. It helps to clean your packages of unused exports with ease.
And it’s also speedy ⚡️

Motivation

We will use the @my/ui-kit package as an example.

ui-kit/src/index.ts

export { Button } from './components/button';
export { Text } from './components/text';

export { ThemeProvider, useTheme, type Theme } from './themes';
...

The number of exports increases over time. All of its exportable code requires support. But is all of it being used?

You can check this manually by just looping through the exports. It’s time-consuming, and there is a chance of error. What if multiple repositories use its code?

Let’s automate this process!

Installation

npm

  npm install -D pure-index

yarn

  yarn add -D pure-index

pnpm

  pnpm add -D pure-index

bun

  bun add -D pure-index

Quick Start

Pure Index can be used either through a command line interface with an optional configuration file or its JavaScript API.

1. Add the check-exports script in the package.json of packages that require checking.

"scripts": {
  "check-exports": "pure-index"
}

2. Run

npm run check-exports

3. Depending on the project, you may need to configure Pure Index.