# tailwindlabs/tailwindcss architecture

> Architecture diagram of the GitHub repository tailwindlabs/tailwindcss, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tailwindlabs/tailwindcss
- Repository: https://github.com/tailwindlabs/tailwindcss

## Overview

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: [`packages/tailwindcss/src/compile.ts`](https://github.com/tailwindlabs/tailwindcss/blob/main/packages/tailwindcss/src/compile.ts) (CSS Compiler), [`packages/tailwindcss/src/ast.ts`](https://github.com/tailwindlabs/tailwindcss/blob/main/packages/tailwindcss/src/ast.ts) (CSS AST), [`packages/@tailwindcss-cli/src/index.ts`](https://github.com/tailwindlabs/tailwindcss/blob/main/packages/%40tailwindcss-cli/src/index.ts) (Build CLI), [`packages/@tailwindcss-upgrade/src/index.ts`](https://github.com/tailwindlabs/tailwindcss/blob/main/packages/%40tailwindcss-upgrade/src/index.ts) (Upgrade CLI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_build["CSS Build"]
  node_cli["Build CLI<br/>[index.ts]"]
  node_scanner["Source Scanner<br/>[mod.rs]"]
  node_extractor["Candidate Extractor<br/>[mod.rs]"]
  node_preprocessors["Template Preprocessors<br/>[mod.rs]"]
end

subgraph group_engine["Compilation Engine"]
  node_compiler["CSS Compiler<br/>[compile.ts]"]
  node_designsystem["Design System<br/>[design-system.ts]"]
  node_cssast["CSS AST<br/>[ast.ts]"]
  node_parser["CSS Parser<br/>[css-parser.ts]"]
  node_generated["Generated CSS<br/>[index.ts]"]
end

subgraph group_integrations["Framework Integrations"]
  node_postcss["PostCSS Adapter<br/>[index.ts]"]
  node_vite["Vite Adapter<br/>[index.ts]"]
  node_webpack["Webpack Adapter<br/>[index.ts]"]
  node_turbopack["Turbopack Adapter<br/>[index.ts]"]
  node_browser["Browser Tooling<br/>[index.ts]"]
end

subgraph group_migration["Upgrade Tooling"]
  node_upgrade["Upgrade CLI<br/>[index.ts]"]
  node_cssmigration["CSS Codemods<br/>[migrate.ts]"]
  node_templatemigration["Template Codemods<br/>[migrate.ts]"]
end

node_developer(("Developer"))

node_developer -->|"invokes"| node_cli
node_cli -.->|"builds from sources"| node_scanner
node_scanner -->|"extracts candidates"| node_extractor
node_extractor -->|"preprocesses templates"| node_preprocessors
node_cli -.->|"invokes build"| node_compiler
node_compiler -->|"uses AST"| node_cssast
node_compiler -.->|"uses design system"| node_designsystem
node_parser -->|"creates nodes"| node_cssast
node_cssast -->|"parses at-rules"| node_parser
node_compiler -.->|"produces CSS"| node_generated
node_postcss -->|"uses AST"| node_cssast
node_developer -.->|"integrates"| node_postcss
node_developer -.->|"integrates"| node_vite
node_developer -.->|"integrates"| node_webpack
node_developer -.->|"integrates"| node_turbopack
node_developer -.->|"uses tooling"| node_browser
node_developer -->|"runs migration"| node_upgrade
node_upgrade -->|"migrates stylesheets"| node_cssmigration
node_upgrade -->|"migrates templates"| node_templatemigration

click node_cli "https://github.com/tailwindlabs/tailwindcss/blob/main/packages/%40tailwindcss-cli/src/index.ts"
click node_scanner "https://github.com/tailwindlabs/tailwindcss/blob/main/crates/oxide/src/scanner/mod.rs"
click node_extractor "https://github.com/tailwindlabs/tailwindcss/blob/main/crates/oxide/src/extractor/mod.rs"
click node_preprocessors "https://github.com/tailwindlabs/tailwindcss/blob/main/crates/oxide/src/extractor/pre_processors/mod.rs"
click node_compiler "https://github.com/tailwindlabs/tailwindcss/blob/main/packages/tailwindcss/src/compile.ts"
click node_designsystem "https://github.com/tailwindlabs/tailwindcss/blob/main/packages/tailwindcss/src/design-system.ts"
click node_cssast "https://github.com/tailwindlabs/tailwindcss/blob/main/packages/tailwindcss/src/ast.ts"
click node_parser "https://github.com/tailwindlabs/tailwindcss/blob/main/packages/tailwindcss/src/css-parser.ts"
click node_generated "https://github.com/tailwindlabs/tailwindcss/blob/main/packages/tailwindcss/src/index.ts"
click node_postcss "https://github.com/tailwindlabs/tailwindcss/blob/main/packages/%40tailwindcss-postcss/src/index.ts"
click node_vite "https://github.com/tailwindlabs/tailwindcss/blob/main/packages/%40tailwindcss-vite/src/index.ts"
click node_webpack "https://github.com/tailwindlabs/tailwindcss/blob/main/packages/%40tailwindcss-webpack/src/index.ts"
click node_turbopack "https://github.com/tailwindlabs/tailwindcss/blob/main/packages/%40tailwindcss-turbopack/src/index.ts"
click node_browser "https://github.com/tailwindlabs/tailwindcss/blob/main/packages/%40tailwindcss-browser/src/index.ts"
click node_upgrade "https://github.com/tailwindlabs/tailwindcss/blob/main/packages/%40tailwindcss-upgrade/src/index.ts"
click node_cssmigration "https://github.com/tailwindlabs/tailwindcss/blob/main/packages/%40tailwindcss-upgrade/src/codemods/css/migrate.ts"
click node_templatemigration "https://github.com/tailwindlabs/tailwindcss/blob/main/packages/%40tailwindcss-upgrade/src/codemods/template/migrate.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_scanner,node_extractor,node_preprocessors toneBlue
class node_compiler,node_designsystem,node_cssast,node_parser,node_generated toneAmber
class node_postcss,node_vite,node_webpack,node_turbopack,node_browser toneMint
class node_upgrade,node_cssmigration,node_templatemigration toneRose
class node_developer toneIndigo
```

## Components

### CSS Build

- [Build CLI](https://github.com/tailwindlabs/tailwindcss/blob/main/packages/%40tailwindcss-cli/src/index.ts): `packages/@tailwindcss-cli/src/index.ts`
- [Source Scanner](https://github.com/tailwindlabs/tailwindcss/blob/main/crates/oxide/src/scanner/mod.rs): `crates/oxide/src/scanner/mod.rs`
- [Candidate Extractor](https://github.com/tailwindlabs/tailwindcss/blob/main/crates/oxide/src/extractor/mod.rs): `crates/oxide/src/extractor/mod.rs`
- [Template Preprocessors](https://github.com/tailwindlabs/tailwindcss/blob/main/crates/oxide/src/extractor/pre_processors/mod.rs): `crates/oxide/src/extractor/pre_processors/mod.rs`

### Compilation Engine

- [CSS Compiler](https://github.com/tailwindlabs/tailwindcss/blob/main/packages/tailwindcss/src/compile.ts): `packages/tailwindcss/src/compile.ts`
- [Design System](https://github.com/tailwindlabs/tailwindcss/blob/main/packages/tailwindcss/src/design-system.ts): `packages/tailwindcss/src/design-system.ts`
- [CSS AST](https://github.com/tailwindlabs/tailwindcss/blob/main/packages/tailwindcss/src/ast.ts): `packages/tailwindcss/src/ast.ts`
- [CSS Parser](https://github.com/tailwindlabs/tailwindcss/blob/main/packages/tailwindcss/src/css-parser.ts): `packages/tailwindcss/src/css-parser.ts`
- [Generated CSS](https://github.com/tailwindlabs/tailwindcss/blob/main/packages/tailwindcss/src/index.ts): `packages/tailwindcss/src/index.ts`

### Framework Integrations

- [PostCSS Adapter](https://github.com/tailwindlabs/tailwindcss/blob/main/packages/%40tailwindcss-postcss/src/index.ts): `packages/@tailwindcss-postcss/src/index.ts`
- [Vite Adapter](https://github.com/tailwindlabs/tailwindcss/blob/main/packages/%40tailwindcss-vite/src/index.ts): `packages/@tailwindcss-vite/src/index.ts`
- [Webpack Adapter](https://github.com/tailwindlabs/tailwindcss/blob/main/packages/%40tailwindcss-webpack/src/index.ts): `packages/@tailwindcss-webpack/src/index.ts`
- [Turbopack Adapter](https://github.com/tailwindlabs/tailwindcss/blob/main/packages/%40tailwindcss-turbopack/src/index.ts): `packages/@tailwindcss-turbopack/src/index.ts`
- [Browser Tooling](https://github.com/tailwindlabs/tailwindcss/blob/main/packages/%40tailwindcss-browser/src/index.ts): `packages/@tailwindcss-browser/src/index.ts`

### Upgrade Tooling

- [Upgrade CLI](https://github.com/tailwindlabs/tailwindcss/blob/main/packages/%40tailwindcss-upgrade/src/index.ts): `packages/@tailwindcss-upgrade/src/index.ts`
- [CSS Codemods](https://github.com/tailwindlabs/tailwindcss/blob/main/packages/%40tailwindcss-upgrade/src/codemods/css/migrate.ts): `packages/@tailwindcss-upgrade/src/codemods/css/migrate.ts`
- [Template Codemods](https://github.com/tailwindlabs/tailwindcss/blob/main/packages/%40tailwindcss-upgrade/src/codemods/template/migrate.ts): `packages/@tailwindcss-upgrade/src/codemods/template/migrate.ts`

### Other components

- **Developer**

## Connections

- Developer → Build CLI: invokes (evidence: `packages/@tailwindcss-cli/src/index.ts`)
- Build CLI → Source Scanner: builds from sources
- Source Scanner → Candidate Extractor: extracts candidates (evidence: `crates/oxide/src/scanner/mod.rs`)
- Candidate Extractor → Template Preprocessors: preprocesses templates (evidence: `crates/oxide/src/extractor/mod.rs`)
- Build CLI → CSS Compiler: invokes build
- CSS Compiler → CSS AST: uses AST (evidence: `packages/tailwindcss/src/ast.ts`)
- CSS Compiler → Design System: uses design system
- CSS Parser → CSS AST: creates nodes (evidence: `packages/tailwindcss/src/css-parser.ts`)
- CSS AST → CSS Parser: parses at-rules (evidence: `packages/tailwindcss/src/ast.ts`)
- CSS Compiler → Generated CSS: produces CSS
- PostCSS Adapter → CSS AST: uses AST (evidence: `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 (evidence: `packages/@tailwindcss-upgrade/src/index.ts`)
- Upgrade CLI → CSS Codemods: migrates stylesheets (evidence: `packages/@tailwindcss-upgrade/src/index.ts`)
- Upgrade CLI → Template Codemods: migrates templates (evidence: `packages/@tailwindcss-upgrade/src/index.ts`)
