# airbnb/javascript architecture

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

- Interactive diagram: https://gitdiagram.com/airbnb/javascript
- Repository: https://github.com/airbnb/javascript

## Overview

This repository provides Airbnb’s JavaScript style guidance and shareable ESLint configurations, including a base JavaScript configuration and a React extension. The principal user workflow is to select a configuration for ESLint to consume; its config entry point composes rule sets, while the React package adds React-specific rules. Whitespace helpers derive a reduced-severity configuration from the main one. The README also documents React and CSS-in-JavaScript guides, but these are documentation directories rather than runtime components. Some rule modules are grouped by directory because their internal wiring was not sampled.

Main entry points: [`packages/eslint-config-airbnb/index.js`](https://github.com/airbnb/javascript/blob/master/packages/eslint-config-airbnb/index.js) (Airbnb Entry), [`packages/eslint-config-airbnb-base/index.js`](https://github.com/airbnb/javascript/blob/master/packages/eslint-config-airbnb-base/index.js) (Base Entry), [`packages/eslint-config-airbnb-base/whitespace.js`](https://github.com/airbnb/javascript/blob/master/packages/eslint-config-airbnb-base/whitespace.js) (Base Whitespace Config), [`packages/eslint-config-airbnb/whitespace.js`](https://github.com/airbnb/javascript/blob/master/packages/eslint-config-airbnb/whitespace.js) (React Whitespace Config)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_base["Base ESLint Config"]
  node_base_entry["Base Entry<br/>[index.js]"]
  node_base_rules["JavaScript Rules"]
  node_base_legacy["Base Legacy Config<br/>[legacy.js]"]
end

subgraph group_react["React Extension"]
  node_airbnb_entry["Airbnb Entry<br/>[index.js]"]
  node_airbnb_base["Base Extension<br/>[base.js]"]
  node_react_rules["React Rules<br/>[react.js]"]
  node_a11y_rules["Accessibility Rules<br/>[react-a11y.js]"]
  node_hooks_rules["Hooks Rules<br/>[react-hooks.js]"]
  node_airbnb_legacy["React Legacy Config<br/>[legacy.js]"]
end

subgraph group_whitespace["Whitespace Config"]
  node_base_whitespace["Base Whitespace Config<br/>[whitespace.js]"]
  node_base_whitespace_async["Base Async Fallback"]
  node_base_whitespace_rules["Base Whitespace Rules<br/>[whitespaceRules.js]"]
  node_react_whitespace["React Whitespace Config<br/>[whitespace.js]"]
  node_react_whitespace_async["React Async Fallback"]
  node_react_whitespace_rules["React Whitespace Rules<br/>[whitespaceRules.js]"]
end

node_eslint_user(("ESLint User"))

node_base_entry -->|"extends rule sets"| node_base_rules
node_airbnb_entry -->|"extends base config"| node_base_entry
node_airbnb_entry -->|"extends React rules"| node_react_rules
node_airbnb_entry -->|"extends accessibility rules"| node_a11y_rules
node_react_rules -->|"reads base style rules"| node_base_rules
node_base_whitespace -->|"loads config"| node_base_entry
node_base_whitespace -->|"loads rule list"| node_base_whitespace_rules
node_base_whitespace -->|"runs fallback"| node_base_whitespace_async
node_base_whitespace_async -->|"loads config"| node_base_entry
node_base_whitespace_async -->|"loads rule list"| node_base_whitespace_rules
node_react_whitespace -->|"loads config"| node_airbnb_entry
node_react_whitespace -->|"loads rule list"| node_react_whitespace_rules
node_react_whitespace -->|"runs fallback"| node_react_whitespace_async
node_react_whitespace_async -->|"loads config"| node_airbnb_entry
node_react_whitespace_async -->|"loads rule list"| node_react_whitespace_rules

click node_base_entry "https://github.com/airbnb/javascript/blob/master/packages/eslint-config-airbnb-base/index.js"
click node_base_rules "https://github.com/airbnb/javascript/tree/master/packages/eslint-config-airbnb-base/rules"
click node_base_legacy "https://github.com/airbnb/javascript/blob/master/packages/eslint-config-airbnb-base/legacy.js"
click node_base_whitespace "https://github.com/airbnb/javascript/blob/master/packages/eslint-config-airbnb-base/whitespace.js"
click node_base_whitespace_async "https://github.com/airbnb/javascript/blob/master/packages/eslint-config-airbnb-base/whitespace-async.js"
click node_base_whitespace_rules "https://github.com/airbnb/javascript/blob/master/packages/eslint-config-airbnb-base/whitespaceRules.js"
click node_airbnb_entry "https://github.com/airbnb/javascript/blob/master/packages/eslint-config-airbnb/index.js"
click node_airbnb_base "https://github.com/airbnb/javascript/blob/master/packages/eslint-config-airbnb/base.js"
click node_react_rules "https://github.com/airbnb/javascript/blob/master/packages/eslint-config-airbnb/rules/react.js"
click node_a11y_rules "https://github.com/airbnb/javascript/blob/master/packages/eslint-config-airbnb/rules/react-a11y.js"
click node_hooks_rules "https://github.com/airbnb/javascript/blob/master/packages/eslint-config-airbnb/rules/react-hooks.js"
click node_airbnb_legacy "https://github.com/airbnb/javascript/blob/master/packages/eslint-config-airbnb/legacy.js"
click node_react_whitespace "https://github.com/airbnb/javascript/blob/master/packages/eslint-config-airbnb/whitespace.js"
click node_react_whitespace_async "https://github.com/airbnb/javascript/blob/master/packages/eslint-config-airbnb/whitespace-async.js"
click node_react_whitespace_rules "https://github.com/airbnb/javascript/blob/master/packages/eslint-config-airbnb/whitespaceRules.js"

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_base_entry,node_base_rules,node_base_legacy,node_eslint_user toneBlue
class node_airbnb_entry,node_airbnb_base,node_react_rules,node_a11y_rules,node_hooks_rules,node_airbnb_legacy toneAmber
class node_base_whitespace,node_base_whitespace_async,node_base_whitespace_rules,node_react_whitespace,node_react_whitespace_async,node_react_whitespace_rules toneMint
```

## Components

### Base ESLint Config

- [Base Entry](https://github.com/airbnb/javascript/blob/master/packages/eslint-config-airbnb-base/index.js): `packages/eslint-config-airbnb-base/index.js`
- [JavaScript Rules](https://github.com/airbnb/javascript/tree/master/packages/eslint-config-airbnb-base/rules): `packages/eslint-config-airbnb-base/rules`
- [Base Legacy Config](https://github.com/airbnb/javascript/blob/master/packages/eslint-config-airbnb-base/legacy.js): `packages/eslint-config-airbnb-base/legacy.js`

### React Extension

- [Airbnb Entry](https://github.com/airbnb/javascript/blob/master/packages/eslint-config-airbnb/index.js): `packages/eslint-config-airbnb/index.js`
- [Base Extension](https://github.com/airbnb/javascript/blob/master/packages/eslint-config-airbnb/base.js): `packages/eslint-config-airbnb/base.js`
- [React Rules](https://github.com/airbnb/javascript/blob/master/packages/eslint-config-airbnb/rules/react.js): `packages/eslint-config-airbnb/rules/react.js`
- [Accessibility Rules](https://github.com/airbnb/javascript/blob/master/packages/eslint-config-airbnb/rules/react-a11y.js): `packages/eslint-config-airbnb/rules/react-a11y.js`
- [Hooks Rules](https://github.com/airbnb/javascript/blob/master/packages/eslint-config-airbnb/rules/react-hooks.js): `packages/eslint-config-airbnb/rules/react-hooks.js`
- [React Legacy Config](https://github.com/airbnb/javascript/blob/master/packages/eslint-config-airbnb/legacy.js): `packages/eslint-config-airbnb/legacy.js`

### Whitespace Config

- [Base Whitespace Config](https://github.com/airbnb/javascript/blob/master/packages/eslint-config-airbnb-base/whitespace.js): `packages/eslint-config-airbnb-base/whitespace.js`
- [Base Async Fallback](https://github.com/airbnb/javascript/blob/master/packages/eslint-config-airbnb-base/whitespace-async.js): `packages/eslint-config-airbnb-base/whitespace-async.js`
- [Base Whitespace Rules](https://github.com/airbnb/javascript/blob/master/packages/eslint-config-airbnb-base/whitespaceRules.js): `packages/eslint-config-airbnb-base/whitespaceRules.js`
- [React Whitespace Config](https://github.com/airbnb/javascript/blob/master/packages/eslint-config-airbnb/whitespace.js): `packages/eslint-config-airbnb/whitespace.js`
- [React Async Fallback](https://github.com/airbnb/javascript/blob/master/packages/eslint-config-airbnb/whitespace-async.js): `packages/eslint-config-airbnb/whitespace-async.js`
- [React Whitespace Rules](https://github.com/airbnb/javascript/blob/master/packages/eslint-config-airbnb/whitespaceRules.js): `packages/eslint-config-airbnb/whitespaceRules.js`

### Other components

- **ESLint User**

## Connections

- Base Entry → JavaScript Rules: extends rule sets (evidence: `packages/eslint-config-airbnb-base/index.js`)
- Airbnb Entry → Base Entry: extends base config (evidence: `packages/eslint-config-airbnb/index.js`)
- Airbnb Entry → React Rules: extends React rules (evidence: `packages/eslint-config-airbnb/index.js`)
- Airbnb Entry → Accessibility Rules: extends accessibility rules (evidence: `packages/eslint-config-airbnb/index.js`)
- React Rules → JavaScript Rules: reads base style rules (evidence: `packages/eslint-config-airbnb/rules/react.js`)
- Base Whitespace Config → Base Entry: loads config (evidence: `packages/eslint-config-airbnb-base/whitespace.js`)
- Base Whitespace Config → Base Whitespace Rules: loads rule list (evidence: `packages/eslint-config-airbnb-base/whitespace.js`)
- Base Whitespace Config → Base Async Fallback: runs fallback (evidence: `packages/eslint-config-airbnb-base/whitespace.js`)
- Base Async Fallback → Base Entry: loads config (evidence: `packages/eslint-config-airbnb-base/whitespace-async.js`)
- Base Async Fallback → Base Whitespace Rules: loads rule list (evidence: `packages/eslint-config-airbnb-base/whitespace-async.js`)
- React Whitespace Config → Airbnb Entry: loads config (evidence: `packages/eslint-config-airbnb/whitespace.js`)
- React Whitespace Config → React Whitespace Rules: loads rule list (evidence: `packages/eslint-config-airbnb/whitespace.js`)
- React Whitespace Config → React Async Fallback: runs fallback (evidence: `packages/eslint-config-airbnb/whitespace.js`)
- React Async Fallback → Airbnb Entry: loads config (evidence: `packages/eslint-config-airbnb/whitespace-async.js`)
- React Async Fallback → React Whitespace Rules: loads rule list (evidence: `packages/eslint-config-airbnb/whitespace-async.js`)
