{"id":20335,"library":"prettier-plugin-astro-organize-imports","title":"prettier-plugin-astro-organize-imports","description":"A Prettier plugin that organizes imports in Astro files by removing unused imports, coalescing duplicate imports, and sorting them using the TypeScript language service API's organizeImports feature. The current stable version is 0.4.12. It is actively maintained with frequent releases. Differentiators: specifically for Astro files, provides explicit compatibility with prettier-plugin-astro and prettier-plugin-tailwindcss through per-plugin workarounds, and supports configurable modes (All, SortAndCombine, RemoveUnused).","status":"active","version":"0.4.12","language":"javascript","source_language":"en","source_url":"https://github.com/oki07/prettier-plugin-astro-organize-imports","tags":["javascript","plugin","formatter","prettier","astro","sort-imports","typescript"],"install":[{"cmd":"npm install prettier-plugin-astro-organize-imports","lang":"bash","label":"npm"},{"cmd":"yarn add prettier-plugin-astro-organize-imports","lang":"bash","label":"yarn"},{"cmd":"pnpm add prettier-plugin-astro-organize-imports","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"peer dependency: requires Prettier ^3.0","package":"prettier","optional":false},{"reason":"peer dependency: required for Astro file parsing","package":"prettier-plugin-astro","optional":true},{"reason":"peer dependency: optional compatibility with Tailwind CSS plugin","package":"prettier-plugin-tailwindcss","optional":true}],"imports":[{"wrong":"Not a module to import in code","symbol":"default","correct":"No import needed; declare in .prettierrc plugins array"},{"note":"This is a Prettier plugin, not a runtime module. Configure via .prettierrc or programmatic Prettier options.","wrong":"Using require('prettier-plugin-astro-organize-imports') in code file","symbol":"prettier-plugin-astro-organize-imports","correct":"In .prettierrc: \"plugins\": [\"prettier-plugin-astro\", \"prettier-plugin-tailwindcss\", \"prettier-plugin-astro-organize-imports\"]"}],"quickstart":{"code":"// .prettierrc\n{\n  \"plugins\": [\n    \"prettier-plugin-astro\",\n    \"prettier-plugin-tailwindcss\",\n    \"prettier-plugin-astro-organize-imports\"\n  ],\n  \"overrides\": [\n    {\n      \"files\": \"*.astro\",\n      \"options\": {\n        \"parser\": \"astro\"\n      }\n    }\n  ],\n  \"astroOrganizeImportsMode\": \"All\"\n}","lang":"javascript","description":"Configuration to enable the plugin for Astro files, with recommended order and mode set to All."},"warnings":[{"fix":"List prettier-plugin-astro-organize-imports as the final entry in the plugins array in .prettierrc.","message":"Plugin must be last in the plugins array to ensure compatibility with prettier-plugin-astro and prettier-plugin-tailwindcss.","severity":"gotcha","affected_versions":">=0.4.0"},{"fix":"Ensure you use TypeScript >=6 or apply a workaround; see release notes.","message":"In v0.4.12, TypeScript 6 organizeImports API change causes semicolons to be added to import statements.","severity":"breaking","affected_versions":">=0.4.12"},{"fix":"Remove those comments from files you intend to format.","message":"Files containing '// organize-imports-ignore' or '// tslint:disable:ordered-imports' are skipped and not processed.","severity":"gotcha","affected_versions":">=0.1.0"},{"fix":"Use astroOrganizeImportsMode instead if available.","message":"The astroOrganizeImportsInScriptTags option added in v0.4.9 may be deprecated in future versions.","severity":"deprecated","affected_versions":"0.4.9"}],"env_vars":null,"last_verified":"2026-04-25T00:00:00.000Z","next_check":"2026-07-24T00:00:00.000Z","problems":[{"fix":"Install prettier-plugin-astro: npm install -D prettier-plugin-astro","cause":"Missing dependency or peer dependency on prettier-plugin-astro which provides Astro compiler.","error":"Error: @astrojs/compiler must be installed to use this plugin"},{"fix":"Install the plugin: npm install -D prettier-plugin-astro-organize-imports. Ensure spelling matches in .prettierrc.","cause":"Plugin not installed or incorrect package name in .prettierrc.","error":"Cannot find module 'prettier-plugin-astro-organize-imports'"},{"fix":"Update Prettier to v3 or later: npm install -D prettier@^3","cause":"Incompatible Prettier version (< 3.0) or misconfiguration.","error":"Error: Failed to load plugin 'prettier-plugin-astro-organize-imports'"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}