Back to Explore

postcss/postcss-import

GitHub
2 watchersOpen source

Last release: 2025-06-17

PostCSS plugin that processes CSS `@import` rules by inlining the imported content into the output. It can resolve imports from local files, node modules, and `web_modules`, making it useful for bundling and transforming CSS across multiple files.

Project status

  • Maintenance status: The repository shows recent activity (an upstream push on 2026-04-27), but the latest published plugin updates in the provided list are older (most recent version 16.1.1 dated 2025-06-17).
  • Update cadence: Based on the provided update history, changes are infrequent (roughly every 1 to 2 years in this sample), with the most recent published update about 11 months before today (2026-06-09).

AI summary generated 2026-06-09

AI-generated from public sources. May be inaccurate. Report

Recent updates

  • 16.1.1

    2025-06-17

    Version 16.1.1 introduces logic changes to how the plugin parses and rewrites CSS @layer statements, particularly when they appear near or alongside @import rules with and without conditions. The diff shows new handling that can transform certain @layer statements into inlined conditional @import equivalents to correct cascade layer ordering.

  • 16.1.0

    2024-03-20

    Release 16.1.0 contains a small behavioral change in URL processing during CSS parsing, plus additions to the test suite. No release notes were provided in the release metadata, so the impact must be inferred from the code diff.

  • 16.0.1

    2024-02-15

    Release 16.0.1 was published on 2024-02-15, but no release notes were provided by the publisher. Because the release notes are missing, the specific developer-impacting changes (bug fixes, breaking changes, security updates, or dependency updates) cannot be determined from the provided information.

  • 14.0.0

    2020-12-14

    postcss-import 14.0.0 introduces stricter handling of CSS @charset rules. It now warns when @charset appears after other statements and throws an error when multiple incompatible @charset encodings are encountered, plus it improves how charset rules are preserved/squashed during import resolution.

    Breaking
  • 13.0.0

    2020-10-20

    PostCSS Import 13.0.0 is a major upgrade that targets a newer runtime and PostCSS 8. The release notes document requiring Node 10+, and switching PostCSS to be a peer dependency. The diff also shows substantial internal refactoring to the PostCSS 8 plugin API and some observable sourcemap/output behavior changes.

    Breaking
  • 12.0.0

    2018-08-04

    Release 12.0.0 primarily updates compatibility and dependencies. It documents dropping Node.js v4 support and switching to PostCSS v7.

    Breaking
  • 11.1.0

    2018-02-10

    Release 11.1.0 introduces an `filter` option intended to conditionally transform `@import` statements. The core code change is in the style import processing path, where imports are skipped when `filter` returns false.

    Features
  • 11.0.0

    2017-09-16

    Release 11.0.0 changes behavior around how postcss syntax errors inside imported files are handled, and it updates symlink resolution to better match Node.js `require`. The code diff also includes a broader ES2015+ refactor (const/let, arrow functions, Object.assign) plus some test, docs, and build tooling updates.

    Breaking
  • 10.0.0

    2017-05-12

    postcss-import 10.0.0 drops legacy compatibility (Node < 4.5, jspm support) and removes the deprecated hooks `addDependencyTo` and `onImport`. It also upgrades to PostCSS v6 and removes the runtime dependency on `promise-each`, replacing it with an in-file sequential promise reduction.

    Breaking
  • 9.1.0

    2017-01-10

    Release 9.1.0 adds support for a new `addModulesDirectories` configuration option to extend PostCSS resolver search paths. The code updates module resolution logic to incorporate the provided directories and adds corresponding tests and documentation.

    Features
  • 9.0.0

    2016-12-03

    postcss-import 9.0.0 removes the `transform` option and changes missing-import handling to throw an error instead of only warning. It also improves resolver and parsing behavior by ensuring custom resolver results are made absolute and by guessing parsers based on imported file extensions.

    BreakingFeatures
  • 8.2.0

    2016-11-10

    Release 8.2.0 improves how postcss-import validates ordering of @import statements and adds a new message type for import dependencies. It also updates documentation to align behavior with the CSS @import specification about statement ordering.

    Features
  • 8.1.3

    2016-11-03

    Release 8.1.3 contains a small change set focused on nested import ordering. The release notes only mention a single fix, but the code diff shows a broader change in how import statements are processed asynchronously.