How tailwindlabs/tailwindcss works
Tailwind CSS is a utility-first CSS framework. In the primary workflow, a developer invokes the CLI to build CSS; source scanning discovers project files, Oxide extracts utility candidates, and the Tailwind compiler turns those candidates and input CSS into generated CSS. The repository also provides framework integrations, browser tooling, and a separate upgrade CLI with CSS and template migrations. Scanner and extractor relationships are visible in excerpts; several package capabilities are represented from the tree, so links to their internal runtime steps are omitted where evidence is unavailable.
Main entry points: compile.ts CSS Compiler · ast.ts CSS AST · src/index.ts Build CLI · src/index.ts Upgrade CLI
Components 18
CSS Build
- Build CLI
packages/@tailwindcss-cli/src/index.ts - Source Scanner
crates/oxide/src/scanner/mod.rs - Candidate Extractor
crates/oxide/src/extractor/mod.rs - Template Preprocessors
crates/oxide/src/extractor/pre_processors/mod.rs
Compilation Engine
- CSS Compiler
packages/tailwindcss/src/compile.ts - Design System
packages/tailwindcss/src/design-system.ts - CSS AST
packages/tailwindcss/src/ast.ts - CSS Parser
packages/tailwindcss/src/css-parser.ts - Generated CSS
packages/tailwindcss/src/index.ts
Framework Integrations
- PostCSS Adapter
packages/@tailwindcss-postcss/src/index.ts - Vite Adapter
packages/@tailwindcss-vite/src/index.ts - Webpack Adapter
packages/@tailwindcss-webpack/src/index.ts - Turbopack Adapter
packages/@tailwindcss-turbopack/src/index.ts - Browser Tooling
packages/@tailwindcss-browser/src/index.ts
Upgrade Tooling
- Upgrade CLI
packages/@tailwindcss-upgrade/src/index.ts - CSS Codemods
packages/@tailwindcss-upgrade/src/codemods/css/migrate.ts - Template Codemods
packages/@tailwindcss-upgrade/src/codemods/template/migrate.ts
Other components
- Developer
Connections 19
- Developer → Build CLI: invokes
packages/@tailwindcss-cli/src/index.ts - Build CLI → Source Scanner: builds from sources
- Source Scanner → Candidate Extractor: extracts candidates
crates/oxide/src/scanner/mod.rs - Candidate Extractor → Template Preprocessors: preprocesses templates
crates/oxide/src/extractor/mod.rs - Build CLI → CSS Compiler: invokes build
- CSS Compiler → CSS AST: uses AST
packages/tailwindcss/src/ast.ts - CSS Compiler → Design System: uses design system
- CSS Parser → CSS AST: creates nodes
packages/tailwindcss/src/css-parser.ts - CSS AST → CSS Parser: parses at-rules
packages/tailwindcss/src/ast.ts - CSS Compiler → Generated CSS: produces CSS
- PostCSS Adapter → CSS AST: uses AST
packages/@tailwindcss-postcss/src/index.ts - Developer → PostCSS Adapter: integrates
- Developer → Vite Adapter: integrates
- Developer → Webpack Adapter: integrates
- Developer → Turbopack Adapter: integrates
- Developer → Browser Tooling: uses tooling
- Developer → Upgrade CLI: runs migration
packages/@tailwindcss-upgrade/src/index.ts - Upgrade CLI → CSS Codemods: migrates stylesheets
packages/@tailwindcss-upgrade/src/index.ts - Upgrade CLI → Template Codemods: migrates templates
packages/@tailwindcss-upgrade/src/index.ts