# Import Integrity

> Helps keep imports correct and tidy

A real codebase carries a lot of intent in how files are organized, i.e. what's reusable, what shouldn't be mixed, and so on. But day-to-day, that intent erodes. Import Integrity is a plugin for ESLint/Oxlint that analyzes imports and exports through your codebase. It flags dead exports, broken boundaries, and other issues that accumulate over time.

## Table of Contents

### Guide

- [Welcome](/import-integrity-lint/guide.md): Start here to learn how to use Import Integrity.
- [Quickstart](/import-integrity-lint/guide/quickstart.md): Install Import Integrity and enable the recommended config.
- [Monorepos](/import-integrity-lint/guide/monorepos.md): Configure Import Integrity in monorepos.
- [Comparisons](/import-integrity-lint/guide/comparisons.md): Performance and accuracy comparisons with eslint-plugin-import and eslint-plugin-import-x.
- [How it works](/import-integrity-lint/guide/how-it-works.md): How Import Integrity analyzes imports and exports.
- [Creating rules](/import-integrity-lint/guide/creating-rules.md): Extend Import Integrity with custom rules.
- [FAQ and caveats](/import-integrity-lint/guide/faq.md): Frequently asked questions and known limitations for Import Integrity.
- [Fast Import Migration](/import-integrity-lint/guide/migration.md): Migrate from Fast Import to Import Integrity.

### Configuration

- [Configuration](/import-integrity-lint/configuration.md): Overview of Import Integrity configuration modes and file locations.
- [Repo-level options](/import-integrity-lint/configuration/repo-level-options.md): Repo-level Import Integrity configuration options.
- [Package-level options](/import-integrity-lint/configuration/package-level-options.md): Package-level Import Integrity configuration options.

### Rules

- [Rules](/import-integrity-lint/rules.md): Reference documentation for Import Integrity lint rules.

### Correctness

- [import-integrity/no-cycle](/import-integrity-lint/rules/no-cycle.md): Ensures that there are no cycles in imports/reexports.
- [import-integrity/no-unused-exports](/import-integrity-lint/rules/no-unused-exports.md): Ensures exports are imported elsewhere in the package.
- [import-integrity/no-unused-package-exports](/import-integrity-lint/rules/no-unused-package-exports.md): Ensures entry point exports are imported by other packages in a monorepo.
- [import-integrity/no-unresolved-imports](/import-integrity-lint/rules/no-unresolved-imports.md): Ensures that module specifiers in import statements resolve to known modules.

### Boundaries

- [import-integrity/no-test-only-imports](/import-integrity-lint/rules/no-test-only-imports.md): Ensures that non-test files' exports are not imported only by test files.
- [import-integrity/no-test-imports-in-prod](/import-integrity-lint/rules/no-test-imports-in-prod.md): Ensures that production code does not import test code.
- [import-integrity/no-restricted-imports](/import-integrity-lint/rules/no-restricted-imports.md): Restricts which files can import which modules.
- [import-integrity/no-node-builtins](/import-integrity-lint/rules/no-node-builtins.md): Disallows imports of Node.js built-in modules.

### Aesthetics

- [import-integrity/prefer-alias-imports](/import-integrity-lint/rules/prefer-alias-imports.md): Enforces the use of alias imports instead of relative paths when an alias is available.
- [import-integrity/require-node-prefix](/import-integrity-lint/rules/require-node-prefix.md): Requires that Node.js built-in module imports are prefixed with node:.

### Footguns

- [import-integrity/no-empty-entry-points](/import-integrity-lint/rules/no-empty-entry-points.md): Flags entry point and externally imported files that have no exports.
- [import-integrity/no-entry-point-imports](/import-integrity-lint/rules/no-entry-point-imports.md): Ensures that exports from entry point files are not imported.
- [import-integrity/no-external-barrel-reexports](/import-integrity-lint/rules/no-external-barrel-reexports.md): Ensures that code does not barrel reexport built-in or third party modules.
- [import-integrity/no-named-as-default](/import-integrity-lint/rules/no-named-as-default.md): Ensures that default imports do not have the same name as a named export in the imported file.
- [import-integrity/no-unnamed-entry-point-exports](/import-integrity-lint/rules/no-unnamed-entry-point-exports.md): Ensures that barrel reexports in entry point files are named.