Registry / testing / prettier-plugin-sorted

prettier-plugin-sorted

library2.0.0jsnpmunverified

A zero-config Prettier plugin for sorting JavaScript and TypeScript imports. Version 2.0.0 requires Prettier ^2.0.0 and ships TypeScript types. It automatically reads tsconfig.json aliases and sorts imports into a fixed order: side effects, node modules, absolute non-aliased, aliased (from tsconfig and extraAliases), relative, and bottom aliases. Supports custom ordering via importSort options, including cache strategy, wildcard placement, and ignored/bottom aliases. Differentiators: minimal setup compared to @trivago/prettier-plugin-sort-imports, automatic alias resolution from tsconfig, and no additional configuration required for most projects. Release cadence is irregular; maintained by community.

testing

npm install prettier-plugin-sorted

package ↗

INSTALL

IMPORT

SIG · PRETTIER-PLUGIN-SO

prettier-plugin-sorted

testingjavascriptv2.0.0

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–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

prettier-plugin-sorted

✓ // Add to .prettierrc: { "plugins": ["prettier-plugin-sorted"] }

✗ require('prettier-plugin-sorted') // Not a direct import; it's a Prettier plugin

No JavaScript import needed; plugin is configured in Prettier config.

importSort

✓ // Add to package.json: "importSort": { ".js, .ts": { "options": { ... } } }

✗ import { importSort } from 'prettier-plugin-sorted' // Not exported

Configuration object placed in package.json, not imported.

Demonstrates installation, configuration, and automatic import sorting behavior.

// 1. Install npm install --save-dev prettier-plugin-sorted prettier // 2. Add to .prettierrc.json: { "plugins": ["prettier-plugin-sorted"] } // 3. Format files: // Test with: npx prettier --write src/**/*.ts // Example input (src/example.ts): import './side-effect'; import { join } from 'path'; import Bar from './bar'; import { foo } from '../foo'; import React from 'react'; // Output after formatting: import './side-effect'; import { join } from 'path'; import React from 'react'; import { foo } from '../foo'; import Bar from './bar';

Debug

Known issues

gotchaPlugin only works with Prettier v2.x; not compatible with Prettier v3.

fix

Use peer dependency prettier@^2.0.0. If using Prettier v3, consider @trivago/prettier-plugin-sort-imports.

affects: >=2.0.0 <3.0.0

deprecatedThe `importSort` configuration object is non-standard and may be removed in a future major version.

fix

Monitor changelog; prefer explicit plugin options if introduced.

affects: >=1.0.0

Errors

Common errors & fixes

Cannot find module 'prettier-plugin-sorted'

Plugin not installed or not in node_modules.

fix

Run: npm install --save-dev prettier-plugin-sorted

Error: Couldn't resolve plugin "prettier-plugin-sorted"

Prettier cannot find the plugin; may be missing from node_modules or not configured correctly.

fix

Ensure plugin is installed and listed in Prettier config file (.prettierrc, .prettierrc.json, or prettier key in package.json).

Upgrade

Version history

2.0.0latest on npm

Audit

Dependencies

prettierrequiredPeer dependency; plugin works as a Prettier plugin

Agent activity

6 hits · last 30 days

node

Resources

packagehttps://www.npmjs.com/package/prettier-plugin-sorted ↗