NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm, #3371 most downloaded on npm
Use light and dark color schemes in all browsers
Latest stable
11.0.1
Last release 4 months ago
22 Jul 2026
Release timing varies
gaps range from 2 weeks to 1.4 years
Nearly every release is documented
notes for 21 of 21 stable releases
Nothing withdrawn
no release was ever pulled
8 years old
21 releases · first in 2018
Drag across the ruler to compare, or tap a release to open it.
Rewritten browser polyfill as ES3
July 22, 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.Updated: Support for Node v18+ (major).
August 3, 2024
Your coding agent can read these notes before it upgrades. Set up the MCP server →
_December 15, 2023_ - Fix type definitions
December 15, 2023
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)Reduce the amount of duplicate fallback CSS.
February 6, 2023
Improve types declaration in package.json
January 28, 2023
types declaration in package.jsonUpdated: Support for Node v14+ (major).
January 24, 2023
Fix: assign global browser polyfill to window, self or a blank object.
August 23, 2022
window, self or a blank object.Breaking: remove color-depth queries fallback
July 8, 2022
color-depth queries fallback- <script src="https://unpkg.com/css-prefers-color-scheme/browser"></script>
+ <script src="https://unpkg.com/css-prefers-color-scheme/dist/browser-global.js"></script>
- <script src="https://unpkg.com/css-prefers-color-scheme/browser.min"></script>
+ <script src="https://unpkg.com/css-prefers-color-scheme/dist/browser-global.js"></script>
prefersColorSchemeInit to initialize the polyfill in the browser.- initPrefersColorScheme()
+ prefersColorSchemeInit()
@media (prefer-color-scheme: no-preference) from your CSS.@media (prefers-color-scheme: no-preference) was removed from the specification and should be equivalent to not having any media query.
- @media (prefers-color-scheme: no-preference) {
- .some-selector {
- /* your styles ... */
- }
- }
+ .some-selector {
+ /* your styles ... */
+ }
_January 31, 2022_ - Fix preserve: false option.
January 31, 2022
preserve: false option.Removed Sourcemaps from package tarball.
January 2, 2022
Fixed: require/import paths for browser script
December 27, 2021
_The old CND url is now deprecated and will be removed in a next major release._ _It will continue to work for now._
December 13, 2021
CSSRuleList edits skipping rules as this is a live list.@media queries not working.Migrating to 6.0.0
PostCSS plugin :
- const postcssPrefersColorScheme = require('css-prefers-color-scheme/postcss');
+ const postcssPrefersColorScheme = require('css-prefers-color-scheme');
Browser Polyfill :
- const prefersColorScheme = require('css-prefers-color-scheme')();
+ const prefersColorScheme = require('css-prefers-color-scheme/browser')();
The old CND url is now deprecated and will be removed in a next major release. It will continue to work for now.
- <script src="https://unpkg.com/css-prefers-color-scheme/browser.min"></script>
+ <script src="https://unpkg.com/css-prefers-color-scheme/dist/browser-global.js"></script>
Updated: Support for PostCS 8+ (major).
September 17, 2021
Updated: postcss to 7.0.16 (patch)
May 24, 2019
postcss to 7.0.16 (patch)Updated: Project organization. No functional changes.
November 10, 2018
Include CLI tool for transforming CSS without any installation
November 10, 2018
Preserve prefers-color-scheme queries by default for non-JS environments
November 4, 2018
prefers-color-scheme queries by default for non-JS environmentsprefers-color-scheme queries on the frontend for JS environmentsThe client library now returns an object with various features, including:
November 3, 2018
scheme to get or set the preferred color schemehasNativeSupport to report whether prefers-color-scheme is supportedonChange to listen for when the preferred color scheme changesremoveListener to destroy the native prefers-color-scheme listener_September 24, 2018_ - Initial version
September 24, 2018
One column per quarter.