ryanmcdermott/clean-code-javascript

Clean Code concepts adapted for JavaScript — Bob Martin's principles translated into JS examples.

What it is

A markdown reference that adapts the principles from Robert C. Martin's Clean Code book into JavaScript-flavored examples. Covers variables, functions, objects, classes, SOLID, testing, concurrency, error handling. Aimed at JS developers who want a one-page reference for code-quality conventions.

Key features

• Per-topic chapters: variables, functions, objects, classes, SOLID, testing, concurrency, error handling, formatting.
• Side-by-side "bad" / "good" code examples.
• Multi-language translations (Chinese, Korean, Japanese, Russian, Spanish, Brazilian Portuguese, etc.).
• MIT-licensed.

Tech stack

• Markdown only.
• JavaScript at the language tag (for the code examples).

When to reach for it

• You're an early-to-mid-career JS developer learning code-quality conventions.
• You're a tech lead setting team coding standards.
• You haven't read the Clean Code book and want the JS-flavored summary.

When not to reach for it

• You disagree with Clean Code's specific opinions (some are debated — e.g. small functions, comments).
• You want a formal style guide — airbnb/javascript is more rule-oriented.

Maturity signal

94k stars, 12k forks, MIT, actively maintained though pace is slow (canonical content doesn't change much).

Alternatives

• Clean Code book by Robert C. Martin — the source.
• airbnb/javascript — for explicit lint-style rules.
• goldbergyoni/nodebestpractices — for Node.js-specific practices.

Tags

awesome-list, javascript, education, clean-code, best-practices, mit-license, learn-to-code