$ show airbnb/javascript
This repository is the canonical Airbnb JavaScript Style Guide, published as a monorepo containing two npm packages: eslint-config-airbnb-base (ESLint config for vanilla JS, no React) and eslint-config-airbnb (extends the base config with React, React Hooks, and JSX-a11y rules). The actual production code lives entirely in the packages/ directory as modular ESLint rule configuration files organized by concern (best-practices, errors, style, variables, es6, imports, node, strict, react, react-a11y, react-hooks). Each rules file is a self-contained module exporting an object with rule names as keys and their configurations as values. The repo also ships a whitespace-only entry point that programmatically downgrades all non-whitespace rules from error to warn, implemented via both a synchronous CLIEngine path and an async ESLint path for backward compatibility across ESLint versions 7 and 8. The architecture is a flat, modular ESLint config package with no runtime application logic. Entry points are index.js (full config), legacy.js (ES5-only subset), whitespace.js (whitespace-only errors), and hooks.js (React Hooks rules only). The whitespace.js file is the most architecturally interesting component: it introspects the resolved ESLint config at runtime, identifies which rules are errors, and selectively downgrades non-whitespace rules to warnings. This dual-path implementation (CLIEngine for ESLint 7, ESLint API for ESLint 8) with a child-process fallback is a pragmatic solution to the deprecated-CLIEngine problem. The repository is actively maintained with recent commits, CI via GitHub Actions testing across Node 12/14/16/17+ and ESLint 7/8 matrices, and peer dependencies pinned to eslint ^7.32.0 || ^8.2.0 and eslint-plugin-import ^2.30.0. The CHANGELOG shows regular semver releases. The main README is a comprehensive style guide document, not application documentation. There is no application runtime, no server, no CLI tool, and no data pipeline — this is purely a distributable ESLint configuration library.
The LLM identified 6 files worth highlighting for reuse:
Programmatically transforms an ESLint config so only whitespace rules remain as errors while all other rules are downgraded to warnings. Uses a dual-path strategy: synchronous CLIEngine API for ESLint 7 and an async child-process call to whitespace-async.js for ESLint 8 (where CLIEngine is removed). The getSeverity helper recursively resolves rule severity from either array or numeric config forms. This is a reusable pattern for any project that needs to create a 'whitespace-only' variant of an ESLint config without manually maintaining a parallel rule set.
A curated array of 48 ESLint rule names that constitute 'whitespace' rules (indentation, spacing, newlines, etc.). This list is the single source of truth for the whitespace-only config entry point. It cleanly separates formatting concerns from logic/style rules, enabling consumers to run a whitespace-only lint pass. The list is reusable as a reference for any team wanting to isolate formatting rules from semantic rules in their ESLint setup.
A thorough, production-grade eslint-plugin-import configuration covering static analysis (no-unresolved, named, export), helpful warnings (no-named-as-default, no-extraneous-dependencies), module systems (no-amd, no-dynamic-require), and style (extensions, order, newline-after-import, prefer-default-export). The no-extraneous-dependencies rule includes an extensive devDependencies whitelist covering test patterns (tape, jest, mocha, spec), config files (webpack, rollup, gulp, grunt, karma, eslint, jest, vue), and mock directories. This is a reusable, well-documented import linting baseline for any Node.js project.
A comprehensive best-practices ESLint rule set covering complexity limits, consistent returns, default cases, error handling (no-empty-function, no-empty-pattern), and strict prohibitions on eval, extend-native, global-assign, and loop-func. The no-param-reassign rule includes a thoughtful ignorePropertyModificationsFor list (acc, accumulator, e, ctx, req, res, $scope, staticContext) that reflects real-world framework patterns (Express, Koa, Angular, React Router). This demonstrates how to balance strict immutability rules with practical framework conventions.
A comprehensive React-specific ESLint configuration covering JSX syntax (jsx-pascal-case, jsx-no-bind, jsx-no-target-blank, jsx-fragments), component structure (sort-comp with a detailed lifecycle ordering), prop validation (prop-types, require-default-props, forbid-prop-types), and modern React patterns (prefer-stateless-function, prefer-es6-class, no-this-in-sfc, function-component-definition). The sort-comp rule defines a precise component method ordering with regex patterns for event handlers (handle.*, on.*) and getter/setter methods. This is a reusable React linting baseline that enforces Airbnb's component conventions.
A thorough jsx-a11y configuration enforcing web accessibility standards: alt-text on images, anchor validity, ARIA prop/role validation, click-events-have-key-events, control-has-associated-label, heading-has-content, html-has-lang, iframe-has-title, interactive-supports-focus, label-has-associated-control, media-has-caption, mouse-events-have-key-events, and tabindex-no-positive. The control-has-associated-label rule includes carefully chosen ignoreElements (audio, canvas, embed, input, textarea, tr, video) and ignoreRoles (grid, listbox, menu, etc.) that reflect real-world component patterns. This is a reusable accessibility linting baseline for any React project.