brettw | f0e606a5 | 2016-07-06 21:17:20 | [diff] [blame] | 1 | # Chromium coding style |
| 2 | |
| 3 | ## Main style guides |
| 4 | |
Jaeheon Yi | 1990e58 | 2021-10-01 22:07:39 | [diff] [blame] | 5 | * [Chromium C++ style guide](c++/c++.md) |
Avi Drissman | 0aafa9e | 2022-01-18 21:41:01 | [diff] [blame] | 6 | * [Modern C++ use](c++/c++-features.md) for allowed/banned features. |
Jaeheon Yi | 1990e58 | 2021-10-01 22:07:39 | [diff] [blame] | 7 | * See also: [C++ Dos and Don'ts](c++/c++-dos-and-donts.md) for Chromium |
| 8 | best-practices. |
Caleb Raitto | 34a6210 | 2025-03-21 20:32:20 | [diff] [blame] | 9 | * [Blink C++ style](c++/blink-c++.md) |
Jaeheon Yi | 1990e58 | 2021-10-01 22:07:39 | [diff] [blame] | 10 | * [Chromium Objective-C style guide](objective-c/objective-c.md) |
| 11 | * [Chromium Swift style guide](swift/swift.md) |
| 12 | * [Java style guide for Android](java/java.md) |
| 13 | * [Chromium Python style guide](python/python.md) |
Caleb Raitto | 34a6210 | 2025-03-21 20:32:20 | [diff] [blame] | 14 | * [Blink Python style](python/blink-python.md) |
Jaeheon Yi | 1990e58 | 2021-10-01 22:07:39 | [diff] [blame] | 15 | * [GN style guide](https://gn.googlesource.com/gn/+/main/docs/style_guide.md) |
| 16 | for build files. |
| 17 | * See also: [Writing GN templates](../build/docs/writing_gn_templates.md) |
| 18 | for Chromium best-practices. |
Ming-Ying Chung | 99ebfd7 | 2023-03-03 01:01:48 | [diff] [blame] | 19 | * [Markdown style guide](markdown/markdown.md) |
brettw | f0e606a5 | 2016-07-06 21:17:20 | [diff] [blame] | 20 | |
| 21 | Chromium also uses these languages to a lesser degree: |
| 22 | |
Jaeheon Yi | 1990e58 | 2021-10-01 22:07:39 | [diff] [blame] | 23 | * [Kernel C style](https://www.kernel.org/doc/html/latest/process/coding-style.html) |
| 24 | for ChromiumOS firmware. |
Caleb Raitto | 34a6210 | 2025-03-21 20:32:20 | [diff] [blame] | 25 | * [WebIDL](https://www.chromium.org/blink/webidl/#syntax) |
| 26 | * [Mojo IDL](../docs/security/mojo.md) for cross-process IPC |
Jaeheon Yi | 1990e58 | 2021-10-01 22:07:39 | [diff] [blame] | 27 | * [Jinja style guide](https://sites.google.com/a/chromium.org/dev/developers/jinja#TOC-Style) |
| 28 | for [Jinja](https://sites.google.com/a/chromium.org/dev/developers/jinja) |
| 29 | templates. |
Caleb Raitto | 37324256 | 2025-03-21 19:40:01 | [diff] [blame] | 30 | * [SQLite SQL style](../sql/README.md#SQL-style) for storage of cookies, etc. |
brettw | f0e606a5 | 2016-07-06 21:17:20 | [diff] [blame] | 31 | |
Jaeheon Yi | 1990e58 | 2021-10-01 22:07:39 | [diff] [blame] | 32 | Regardless of the language used, please keep code |
| 33 | [inclusive for all contributors](inclusive_code.md). |
benwells | 3ab4165 | 2017-03-31 22:20:42 | [diff] [blame] | 34 | |
brettw | f0e606a5 | 2016-07-06 21:17:20 | [diff] [blame] | 35 | ## Web languages (JavaScript, HTML, CSS) |
| 36 | |
Jaeheon Yi | 1990e58 | 2021-10-01 22:07:39 | [diff] [blame] | 37 | When working on Web-based UI features, consult the |
| 38 | [Web Development Style Guide](web/web.md) for the Chromium conventions used in |
| 39 | JS/CSS/HTML files. |
brettw | f0e606a5 | 2016-07-06 21:17:20 | [diff] [blame] | 40 | |
Jaeheon Yi | 1990e58 | 2021-10-01 22:07:39 | [diff] [blame] | 41 | Internal uses of web languages, notably "layout" tests, should preferably follow |
| 42 | these style guides, but it is not enforced. |