postcss

A CSS transformation engine that parses styles into an AST, letting JS plugins lint, prefix, and rewrite CSS — the foundation beneath Autoprefixer, Tailwind, and 200+ other tools.

Library
npm
v8.5.32
28,964 stars
MIT License

Repository Health

Pre-computed score based on development activity, maintenance, community, maturity, and trend momentum. How we score it →
92 /100 Excellent
Development Activity 96
Maintenance 96
Community 76
Maturity 60
Momentum 40

Technical Analysis

AI-assessed by reading the actual repository — architecture, code quality, innovation, and documentation. How we score it →
88 /100 Excellent
Architecture 92
Code Quality 93
Innovation 88
Learning Curve 80

PostCSS parses CSS into an abstract syntax tree and exposes that tree to a pipeline of JavaScript plugins, each free to inspect or rewrite rules, declarations, and at-rules before the result is stringified back to CSS. It doesn’t impose its own syntax the way a preprocessor like Sass does — it works with real CSS (and CSS-like syntaxes via pluggable parsers) and lets the plugin ecosystem, not the core, decide what transformations happen.

That plugin model has made PostCSS the shared foundation underneath more than 200 published plugins, including Autoprefixer for vendor prefixing and Tailwind CSS’s own processing pipeline. The core ships as a small, dependency-light library (three runtime dependencies) with hand-maintained TypeScript type definitions, 100%-enforced test coverage, and a decade-old plugin contract that has stayed stable enough for that whole ecosystem to build on top of it without breaking changes.

What You Get

  • A stable, class-based CSS AST (Root/Rule/AtRule/Declaration/Comment) with walk* traversal helpers for writing your own transformations.
  • A processing pipeline (postcss(plugins).process(css)) that supports both synchronous and asynchronous plugins.
  • Built-in source map generation and consumption for tracing transformed CSS back to its original source.
  • Typed CSS syntax errors with optional terminal-highlighted output pointing at the exact source location of a parse failure.

Common Use Cases

  • Running Autoprefixer, Tailwind CSS, or cssnano — all of which are PostCSS plugins under the hood.
  • Writing a custom lint rule or codemod that needs to inspect or rewrite CSS programmatically.
  • Parsing non-standard CSS-like syntaxes (Sass, Less, CSS-in-JS template literals) via one of PostCSS’s pluggable syntax parsers.

Under The Hood

Architecture

PostCSS splits CSS processing into three explicit stages: a tokenizer (lib/tokenize.js) that turns a raw CSS string into a flat token stream, a parser (lib/parser.js) that assembles those tokens into a class-based AST rooted at a Root node with Rule/AtRule/Declaration/Comment children, and a stringifier that walks the same AST back into CSS text. Plugins operate entirely on the AST between the parse and stringify stages, using walkDecls/walkRules/walkAtRules traversal helpers inherited from a shared Container base class. This split — the project’s own architecture documentation explicitly justifies it on performance and readability grounds — is what lets a decade of downstream plugins (Autoprefixer, cssnano, postcss-nested, and 200+ others) share one stable core without needing to write their own parser.

Tech Stack

The runtime is plain, unbundled JavaScript published directly to npm, with dual CommonJS/ESM entry points declared via package.json’s exports map. TypeScript is used only for the test suite (via ts-node) and for hand-authored .d.ts type declarations shipped alongside the JS — there is no build-time compilation step for the library itself. Runtime dependencies are deliberately minimal: nanoid for identifier generation, picocolors for terminal-colored error output, and source-map-js for source map handling. Node’s engines field (^10 || ^12 || >=14) reflects an unusually wide backward-compatibility commitment for an actively maintained library.

Code Quality

26 TypeScript test files run through the lightweight uvu test runner, with a c8 coverage configuration that enforces 100% line coverage as a hard requirement, not an aspiration. A dedicated fuzzing directory hardens the parser against malformed input, and separate integration.js/old-node.js scripts test cross-Node-version behavior. ESLint runs as its own required test step, and the shipped .d.ts type definitions are validated with check-dts rather than trusted as-authored. This is a mature, rigorously tested codebase commensurate with sitting underneath hundreds of other packages’ CI pipelines.

API Design The public surface is a single factory function, postcss(…plugins), returning a Processor whose .process(css) result supports both synchronous .css access and .then() for pipelines containing async plugins. The AST’s walk* traversal methods mirror patterns familiar from other JS-ecosystem AST tools (e.g. Babel’s visitor style), which lowers the learning curve for anyone who has written a codemod before. The main friction newcomers hit is historical: a deprecated postcss.plugin() helper (kept for backward compatibility, emits a runtime warning) and the dual CJS/ESM export surface both add a small amount of legacy surface area a brand-new API wouldn’t have.

Used by 270 apps in this directory

TypeScript
88%
Other

Webiny JS

Blogging · CMS · Ecommerce

8,049

Open-source, self-hosted CMS on AWS serverless — a TypeScript framework you extend with code, not a product you configure through a UI.

View details
90
Repo Health
86
Technical
61
Dependency
Built with
TypeScript 88%
JavaScript 11%
Updated 1 weeks ago
Svelte
45%
Apache 2.0

WebVM

Developer Tools

17,468

Run a full Linux virtual machine entirely in your browser using WebAssembly — no server required.

View details
71
Repo Health
67
Technical
0
Dependency
Built with
Svelte 45%
JavaScript 43%
Updated 2 weeks ago
Rust
33%
Other

Windmill

Automation · Developer Tools

18,443

Turn scripts into webhooks, workflows, and auto-generated UIs — the fastest self-hostable workflow engine, 13x faster than Airflow.

View details
91
Repo Health
82
Technical
64
Dependency
Built with
Rust 33%
TypeScript 23%
Svelte 22%
Updated 1 weeks ago
TypeScript
96%
GPL 3.0

Wire

Collaboration · Team Chat · Video Conferencing

1,191

Open source end-to-end encrypted messaging for teams and enterprises — self-host for complete control over your communications and data.

View details
93
Repo Health
8
Technical
68
Dependency
Built with
TypeScript 96%
Updated 1 weeks ago
PHP
64%
Other

WordPress

Blogging · CMS

21,519

The world's most popular open-source CMS — now with a built-in AI client SDK, 196 native blocks, and full-site editing for PHP-powered publishing at any scale.

View details
88
Repo Health
58
Technical
59
Dependency
Built with
PHP 64%
JavaScript 21%
CSS 14%
Updated 1 weeks ago
TypeScript
72%
AGPL 3.0

Worklenz

Collaboration · Product Management · Project Management

3,296

All-in-one open source project management for teams who want full control — plan projects, track tasks, manage resources, and monitor finances without the SaaS lock-in.

View details
87
Repo Health
7
Technical
64
Dependency
Built with
TypeScript 72%
JavaScript 21%
Updated 1 weeks ago
PHP
72%
MIT

Yaffa

Invoicing Finance

113

Self-hosted personal finance app for long-term financial planning with AI-powered transaction parsing and investment tracking.

View details
80
Repo Health
78
Technical
67
Dependency
Built with
PHP 72%
Vue 24%
Updated 1 weeks ago
Go
74%
AGPL 3.0

ZITADEL

Authentication

15,536

Open-source, API-first identity platform delivering multi-tenancy, Passkeys, OIDC, SAML, and SCIM without vendor lock-in.

View details
91
Repo Health
81
Technical
65
Dependency
Built with
Go 74%
TypeScript 12%
Updated 2 weeks ago
Python
57%
Apache 2.0

Zulip

Team Chat

26,182

Topic-based team chat that brings the structure of email threads to real-time messaging, so distributed teams never lose context across hundreds of concurrent conversations.

View details
96
Repo Health
86
Technical
61
Dependency
Built with
Python 57%
TypeScript 19%
JavaScript 11%
Updated 1 weeks ago

Join founders buildingwith open source

Opinionated takes, migration guides, cost-saving tips, and insights from the open source ecosystem.

Subscribe on Substack
Join 750+ subscribers