# Npm Audit Export 🕵️‍♂️

<p align="center">
  <a href="https://www.hotay.dev">
    <picture>
        <source media="(prefers-color-scheme: dark)" srcset="https://www.hotay.dev/logo/logo-light.svg" width="150">
        <source media="(prefers-color-scheme: light)" srcset="https://www.hotay.dev/logo/logo-dark.svg" width="150">
        <img alt="Hotay Logo" src="https://www.hotay.dev/logo/logo-dark.svg" width="150">
    </picture>
  </a>
</p>

<p align="center">
  A <a href="https://www.hotay.dev">Hotay</a> project. If you like our work, please <a href="https://github.com/hotaydev/">follow us on GitHub</a>!
</p>

<p align="center">
  <a href="https://www.npmjs.com/package/audit-export">
    <img src="https://img.shields.io/npm/v/audit-export?style=flat-square" alt="npm version">
  </a>
  <a href="https://www.npmjs.com/package/audit-export">
    <img src="https://img.shields.io/npm/dy/audit-export?style=flat-square" alt="npm downloads">
  </a>
  <a href="https://github.com/hotaydev/audit-export/blob/main/LICENSE">
    <img alt="GitHub License" src="https://img.shields.io/github/license/hotaydev/audit-export?style=flat-square">
  </a>
</p>

A convenient tool to **export npm audit results** to a comprehensive **offline HTML page**, providing a clear overview of your project's vulnerabilities.

<div align="center" width="100%">
    <img src="https://raw.githubusercontent.com/hotaydev/audit-export/refs/heads/main/.github/images/screenshot.jpg" alt="Screenshot of the output of audit-export"/><br/>
    <sub align="center">Example of the output file from audit-export</sub>
</div><br/><br/>

> Inspired by [npm-audit-html](https://www.npmjs.com/package/npm-audit-html), but with more Node.js versions supported, offline support and lightweight ⚡

## Table of Contents

- [Main Features](#main-features)
- [Compatibility](#compatibility)
- [Supported Audit Tools](#supported-audit-tools)
- [Installation](#installation)
- [Usage](#usage)
- [Contributing](#contributing)
- [Download](#download)
- [License](#license)

## Main Features

- **Lightweight & Efficient**
- **Fully Offline Functionality**
- **Advanced Filters, Search, and Ordering**
- **Tags Filtering Supported**
- **Supports projects since Node v10**
- **Download results as CSV or JSON**

## Compatibility

**This package supports Node.js versions 10 through 22, as well as future versions.**

## Supported Audit Tools

This tool processes the JSON output from your audit tool. It works with:

- `npm audit --json`
- `pnpm audit --json`
- `yarn audit --json`

## Installation

Install globally using your preferred package manager:

```bash
npm install -g audit-export
pnpm install -g audit-export
yarn global add audit-export
```

## Usage

Pipe the JSON output from your audit command into `audit-export`:

```bash
npm audit --json | audit-export
pnpm audit --json | audit-export
yarn audit --json | audit-export
```

Customize the output path and HTML title:

```bash
npm audit --json | audit-export --path <output_path> --title <report_title> [--open]
```

- `--path`: output file or directory (default: `./audit-report.html`)
- `--title`: HTML report title (default: `NPM Audit Report`)
- `--open`: automatically open the report in your default browser

For all options and advanced usage, run:

```bash
audit-export --help
```

## Usage Syntax Breaking Changes

In versions **lower or equal than 3**, folder and file were separate parameters. **After version 4** both were merged into a single `--path` parameter, that can be the folder, the file, or both. Previously it was `--folder` and `--file`, now removed parameters.

## Contributing

We welcome contributions from the community! Feel free to open issues and submit pull requests on our [GitHub Issues page](https://github.com/hotaydev/audit-export/issues). Your feedback and suggestions are highly appreciated.

## Download

You can download the package from [npm](https://www.npmjs.com/package/audit-export).

## License

This project is licensed under the MIT License - see the [LICENSE](https://github.com/hotaydev/audit-export/blob/main/LICENSE) file for details.

Happy auditing! 🛡️🚀