{"id":20429,"library":"prettier-plugin-sorted","title":"prettier-plugin-sorted","description":"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.","status":"active","version":"2.0.0","language":"javascript","source_language":"en","source_url":null,"tags":["javascript","import-sort","prettier","sort","typescript","plugin","tsconfig","alias"],"install":[{"cmd":"npm install prettier-plugin-sorted","lang":"bash","label":"npm"},{"cmd":"yarn add prettier-plugin-sorted","lang":"bash","label":"yarn"},{"cmd":"pnpm add prettier-plugin-sorted","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Peer dependency; plugin works as a Prettier plugin","package":"prettier","optional":false}],"imports":[{"note":"No JavaScript import needed; plugin is configured in Prettier config.","wrong":"require('prettier-plugin-sorted') // Not a direct import; it's a Prettier plugin","symbol":"prettier-plugin-sorted","correct":"// Add to .prettierrc: { \"plugins\": [\"prettier-plugin-sorted\"] }"},{"note":"Configuration object placed in package.json, not imported.","wrong":"import { importSort } from 'prettier-plugin-sorted' // Not exported","symbol":"importSort","correct":"// Add to package.json: \"importSort\": { \".js, .ts\": { \"options\": { ... } } }"}],"quickstart":{"code":"// 1. Install\nnpm install --save-dev prettier-plugin-sorted prettier\n\n// 2. Add to .prettierrc.json:\n{\n  \"plugins\": [\"prettier-plugin-sorted\"]\n}\n\n// 3. Format files:\n// Test with: npx prettier --write src/**/*.ts\n\n// Example input (src/example.ts):\nimport './side-effect';\nimport { join } from 'path';\nimport Bar from './bar';\nimport { foo } from '../foo';\nimport React from 'react';\n\n// Output after formatting:\nimport './side-effect';\nimport { join } from 'path';\nimport React from 'react';\nimport { foo } from '../foo';\nimport Bar from './bar';","lang":"typescript","description":"Demonstrates installation, configuration, and automatic import sorting behavior."},"warnings":[{"fix":"Use peer dependency prettier@^2.0.0. If using Prettier v3, consider @trivago/prettier-plugin-sort-imports.","message":"Plugin only works with Prettier v2.x; not compatible with Prettier v3.","severity":"gotcha","affected_versions":">=2.0.0 <3.0.0"},{"fix":"Monitor changelog; prefer explicit plugin options if introduced.","message":"The `importSort` configuration object is non-standard and may be removed in a future major version.","severity":"deprecated","affected_versions":">=1.0.0"}],"env_vars":null,"last_verified":"2026-04-25T00:00:00.000Z","next_check":"2026-07-24T00:00:00.000Z","problems":[{"fix":"Run: npm install --save-dev prettier-plugin-sorted","cause":"Plugin not installed or not in node_modules.","error":"Cannot find module 'prettier-plugin-sorted'"},{"fix":"Ensure plugin is installed and listed in Prettier config file (.prettierrc, .prettierrc.json, or prettier key in package.json).","cause":"Prettier cannot find the plugin; may be missing from node_modules or not configured correctly.","error":"Error: Couldn't resolve plugin \"prettier-plugin-sorted\""}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}