NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm · #3140 most downloaded on npm
Use Custom Media Queries in CSS
Last release 3 days ago
01 Oct 2026
Release timing varies
gaps range from 9 days to 8 months
Most releases are documented
notes for 40 of 52 stable releases
Nothing withdrawn
no release was ever pulled
12 years old
52 releases · first in 2014
Updated `@csstools/css-parser-algorithms` to `4.0.2` (patch)
October 1, 2026
@csstools/css-parser-algorithms to 4.0.2 (patch)@csstools/cascade-layer-name-parser to 3.0.2 (patch)@csstools/media-query-list-parser to 5.0.2 (patch)Fix exponential growth of cascade layer names for deeply nested @layer rules
One column per quarter.
September 25, 2026
@layer rules@layer nesting exceeds a safe depth@csstools/css-tokenizer to 4.0.1 (patch)@csstools/css-tokenizer to 4.0.2 (patch)@csstools/css-parser-algorithms to 4.0.1 (patch)@csstools/cascade-layer-name-parser to 3.0.1 (patch)@csstools/media-query-list-parser to 5.0.1 (patch)Fix importance of custom media in anonymous cascade layers.
February 21, 2026
Updated: Support for Node 20.19.0 or later (major).
January 14, 2026
20.19.0 or later (major).commonjs API. In supported Node versions require(esm) will work without needing to make code changes.@csstools/css-tokenizer to 4.0.0 (major)@csstools/css-parser-algorithms to 4.0.0 (major)@csstools/cascade-layer-name-parser to 3.0.0 (major)@csstools/media-query-list-parser to 5.0.0 (major)Updated `@csstools/css-tokenizer` to `3.0.4` (patch)
May 27, 2025
@csstools/css-tokenizer to 3.0.4 (patch)@csstools/css-parser-algorithms to 3.0.5 (patch)@csstools/cascade-layer-name-parser to 2.0.5 (patch)@csstools/media-query-list-parser to 4.0.3 (patch)Updated `@csstools/css-tokenizer` to `3.0.3` (patch)
November 1, 2024
@csstools/css-tokenizer to 3.0.3 (patch)@csstools/css-parser-algorithms to 3.0.4 (patch)@csstools/cascade-layer-name-parser to 2.0.4 (patch)@csstools/media-query-list-parser to 4.0.2 (patch)Updated `@csstools/css-parser-algorithms` to `3.0.3` (patch)
October 23, 2024
@csstools/css-parser-algorithms to 3.0.3 (patch)@csstools/cascade-layer-name-parser to 2.0.3 (patch)@csstools/media-query-list-parser to 4.0.1 (patch)Fix inversion of logical expressions
October 10, 2024
@csstools/css-tokenizer to 3.0.2 (patch)@csstools/css-parser-algorithms to 3.0.2 (patch)@csstools/cascade-layer-name-parser to 2.0.2 (patch)@csstools/media-query-list-parser to 4.0.0 (major)Fix @custom-media --foo screen; @media (color) and (--foo) {} not transforming.
October 4, 2024
@custom-media --foo screen; @media (color) and (--foo) {} not transforming.Updated `@csstools/css-tokenizer` to `3.0.1` (patch)
August 18, 2024
@csstools/css-tokenizer to 3.0.1 (patch)@csstools/css-parser-algorithms to 3.0.1 (patch)@csstools/cascade-layer-name-parser to 2.0.1 (patch)@csstools/media-query-list-parser to 3.0.1 (patch)Updated: Support for Node v18+ (major).
August 3, 2024
@csstools/css-tokenizer to 3.0.0 (major)@csstools/css-parser-algorithms to 3.0.0 (major)@csstools/cascade-layer-name-parser to 2.0.0 (major)@csstools/media-query-list-parser to 3.0.0 (major)Updated `@csstools/css-tokenizer` to `2.4.1` (patch)
July 6, 2024
@csstools/css-tokenizer to 2.4.1 (patch)@csstools/css-parser-algorithms to 2.7.1 (patch)@csstools/cascade-layer-name-parser to 1.0.13 (patch)@csstools/media-query-list-parser to 2.1.13 (patch)Updated `@csstools/css-tokenizer` to `2.3.2` (patch)
June 29, 2024
@csstools/css-tokenizer to 2.3.2 (patch)@csstools/css-parser-algorithms to 2.7.0 (minor)@csstools/cascade-layer-name-parser to 1.0.12 (patch)@csstools/media-query-list-parser to 2.1.12 (patch)Updated `@csstools/css-tokenizer` to `2.3.1` (patch)
May 4, 2024
@csstools/css-tokenizer to 2.3.1 (patch)@csstools/css-parser-algorithms to 2.6.3 (patch)@csstools/cascade-layer-name-parser to 1.0.11 (patch)@csstools/media-query-list-parser to 2.1.11 (patch)Updated `@csstools/css-tokenizer` to `2.3.0` (minor)
May 4, 2024
@csstools/css-tokenizer to 2.3.0 (minor)@csstools/css-parser-algorithms to 2.6.2 (patch)@csstools/cascade-layer-name-parser to 1.0.10 (patch)@csstools/media-query-list-parser to 2.1.10 (patch)Updated `@csstools/css-tokenizer` to `2.2.4` (patch)
March 13, 2024
@csstools/css-tokenizer to 2.2.4 (patch)@csstools/css-parser-algorithms to 2.6.1 (patch)@csstools/cascade-layer-name-parser to 1.0.9 (patch)@csstools/media-query-list-parser to 2.1.9 (patch)Updated `@csstools/cascade-layer-name-parser` to `1.0.8` (patch)
February 19, 2024
@csstools/cascade-layer-name-parser to 1.0.8 (patch)@csstools/css-parser-algorithms to 2.6.0 (minor)@csstools/css-tokenizer to 2.2.3 (patch)@csstools/media-query-list-parser to 2.1.8 (patch)Updated `@csstools/css-tokenizer` to `2.2.1` (patch)
October 9, 2023
@csstools/css-tokenizer to 2.2.1 (patch)@csstools/css-parser-algorithms to 2.3.2 (patch)@csstools/cascade-layer-name-parser to 1.0.5 (patch)@csstools/media-query-list-parser to 2.1.5 (patch)Updated `@csstools/css-tokenizer` to `2.2.0` (minor)
September 18, 2023
@csstools/css-tokenizer to 2.2.0 (minor)@csstools/css-parser-algorithms to 2.3.1 (patch)@csstools/cascade-layer-name-parser to 1.0.4 (patch)@csstools/media-query-list-parser to 2.1.4 (patch)Change license to MIT-0 (read more about this change in the blog post)
July 3, 2023
MIT-0 (read more about this change in the blog post)@csstools/css-parser-algorithms to 2.3.0 (minor)@csstools/cascade-layer-name-parser to 1.0.3 (patch)@csstools/media-query-list-parser to 2.1.2 (patch)Updated @csstools/media-query-list-parser to 2.1.1 (patch)
June 21, 2023
@csstools/media-query-list-parser to 2.1.1 (patch)Updated @csstools/media-query-list-parser to 2.1.0 (minor)
June 1, 2023
@csstools/media-query-list-parser to 2.1.0 (minor)Updated @csstools/css-tokenizer to 2.1.1 (patch)
April 10, 2023
@csstools/css-tokenizer to 2.1.1 (patch)@csstools/css-parser-algorithms to 2.1.1 (patch)@csstools/cascade-layer-name-parser to 1.0.2 (patch)@csstools/media-query-list-parser to 2.0.4 (patch)Fixed: exception on missing media queries.
February 8, 2023
Improve types declaration in package.json
January 28, 2023
types declaration in package.jsonAdded: Support for Cascade Layers.
January 24, 2023
Fixed: avoid complex generated CSS when @custom-media contains only a single simple media feature.
November 19, 2022
@custom-media contains only a single simple media feature.Updated: Support for Node v14+ (major).
November 14, 2022
importFrom feature (breaking).exportTo feature (breaking).@media --foo {} (breaking).true and false keywords in @custom-media.Fixed: dependency declarations in package.json
June 4, 2022
Updated: use specific AtRule visitor
June 3, 2022
@custom-media --🧑🏾🎤 (min-width: 320px);)@media ( --mq-1 );) (https://github.com/csstools/postcss-custom-media/pull/59) (https://github.com/csstools/postcss-custom-media/pull/71)_January 12, 2021_ - Added: Support for PostCSS v8
January 12, 2021
Fixed: Issue importing from .pcss files
March 30, 2019
.pcss filespostcss to 7.0.14 (patch)Fixed: Issue combining custom media media queries with and
October 19, 2018
andFixed: Issue combining multiple custom media
October 12, 2018
Fixed: Possible issues resolving paths to imports and exports
October 5, 2018
customMedia and custom-media simultaneouslypostcss to 7.0.5Added: importFromPlugins option to process imports
September 23, 2018
importFromPlugins option to process importsFixed: Do not break on an empty importFrom object
September 20, 2018
importFrom objectFixed: An issue with re-assigning params as a non-string
September 15, 2018
Fixed: An issue with how opposing queries are resolved.
September 14, 2018
Added: New preserve option to preserve custom media and atrules using them
September 14, 2018
preserve option to preserve custom media and atrules using themexportTo function to specify where to export custom mediaimportFrom option to specify where to import custom media-- prefixing
(https://github.com/postcss/postcss-custom-media/issues/11)preserve allows you to preserve custom media query defintionsappendExtensions allows you (when preserve is truthy) to append your extensions as media queriesYou never saw this version (this is a bad release that points to 1.0.0).
✨ First release based on https://github.com/reworkcss/rework-custom-media v0.1.1
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →