Yang Guo | 4fd355c | 2019-09-19 08:59:03 | [diff] [blame] | 1 | # Chrome DevTools frontend |
| 2 | |
| 3 | <!-- [START badges] --> |
Mathias Bynens | 1ff270d | 2020-06-22 08:59:31 | [diff] [blame] | 4 | |
| 5 | [](https://npmjs.org/package/chrome-devtools-frontend) |
| 6 | |
Yang Guo | 4fd355c | 2019-09-19 08:59:03 | [diff] [blame] | 7 | <!-- [END badges] --> |
| 8 | |
| 9 | The client-side of the Chrome DevTools, including all JS & CSS to run the DevTools webapp. |
| 10 | |
Yang Guo | 4fd355c | 2019-09-19 08:59:03 | [diff] [blame] | 11 | ### Source code |
Mathias Bynens | 1ff270d | 2020-06-22 08:59:31 | [diff] [blame] | 12 | |
Yang Guo | 4fd355c | 2019-09-19 08:59:03 | [diff] [blame] | 13 | The frontend is available on [chromium.googlesource.com](https://chromium.googlesource.com/devtools/devtools-frontend). |
| 14 | |
Mathias Bynens | 1ff270d | 2020-06-22 08:59:31 | [diff] [blame] | 15 | ### Design guidelines |
| 16 | |
Yang Guo | 03e780e | 2020-06-17 10:18:09 | [diff] [blame] | 17 | Please be aware that DevTools follows additional [development guidelines](docs/design_guidelines.md). |
Michael Hablich | 37becd0 | 2019-11-12 22:01:01 | [diff] [blame] | 18 | |
Michael Hablich | c73ffd7 | 2020-05-18 12:05:21 | [diff] [blame] | 19 | ### Issue triage |
Mathias Bynens | 1ff270d | 2020-06-22 08:59:31 | [diff] [blame] | 20 | |
Jack Franklin | 870ce57 | 2021-02-02 07:30:15 | [diff] [blame] | 21 | The issue triage guidelines can be found [in docs/triage_guidelines.md](docs/triage_guidelines.md). |
Michael Hablich | c73ffd7 | 2020-05-18 12:05:21 | [diff] [blame] | 22 | |
Yang Guo | 736b043 | 2019-10-31 07:20:48 | [diff] [blame] | 23 | ### Workflows |
Mathias Bynens | 1ff270d | 2020-06-22 08:59:31 | [diff] [blame] | 24 | |
Jack Franklin | 870ce57 | 2021-02-02 07:30:15 | [diff] [blame] | 25 | Instructions to set up, use, and maintain a DevTools frontend checkout can be found [in docs/workflows.md](docs/workflows.md). |
Yang Guo | 736b043 | 2019-10-31 07:20:48 | [diff] [blame] | 26 | |
| 27 | ### Additional references |
Mathias Bynens | 1ff270d | 2020-06-22 08:59:31 | [diff] [blame] | 28 | |
| 29 | - DevTools documentation: [devtools.chrome.com](https://devtools.chrome.com/) |
| 30 | - [Debugging protocol docs](https://developer.chrome.com/devtools/docs/debugger-protocol) and [Chrome Debugging Protocol Viewer](https://chromedevtools.github.io/debugger-protocol-viewer/) |
| 31 | - [awesome-chrome-devtools](https://github.com/paulirish/awesome-chrome-devtools): recommended tools and resources |
| 32 | - Contributing to DevTools: [bit.ly/devtools-contribution-guide](https://bit.ly/devtools-contribution-guide) |
| 33 | - Contributing To Chrome DevTools Protocol: [docs.google.com](https://docs.google.com/document/d/1c-COD2kaK__5iMM5SEx-PzNA7HFmgttcYfOHHX0HaOM/edit?usp=sharing) |
| 34 | - DevTools Design Review Guidelines: [design_guidelines.md](docs/design_guidelines.md) |
Yang Guo | 4fd355c | 2019-09-19 08:59:03 | [diff] [blame] | 35 | |
Yang Guo | 736b043 | 2019-10-31 07:20:48 | [diff] [blame] | 36 | ### Source mirrors |
Mathias Bynens | 1ff270d | 2020-06-22 08:59:31 | [diff] [blame] | 37 | |
Yang Guo | 736b043 | 2019-10-31 07:20:48 | [diff] [blame] | 38 | DevTools frontend repository is mirrored on [GitHub](https://github.com/ChromeDevTools/devtools-frontend). |
Yang Guo | 4fd355c | 2019-09-19 08:59:03 | [diff] [blame] | 39 | |
Mathias Bynens | 1ff270d | 2020-06-22 08:59:31 | [diff] [blame] | 40 | DevTools frontend is also available on NPM as the [chrome-devtools-frontend](https://www.npmjs.com/package/chrome-devtools-frontend) package. It's not currently available via CJS or ES modules, so consuming this package in other tools may require [some effort](https://github.com/paulirish/devtools-timeline-model/blob/master/index.js). |
Yang Guo | 2b9efe8 | 2019-10-21 10:06:34 | [diff] [blame] | 41 | |
| 42 | The version number of the npm package (e.g. `1.0.373466`) refers to the Chromium commit position of latest frontend git commit. It's incremented with every Chromium commit, however the package is updated roughly daily. |
| 43 | |
Yang Guo | 4fd355c | 2019-09-19 08:59:03 | [diff] [blame] | 44 | ### Getting in touch |
Mathias Bynens | 1ff270d | 2020-06-22 08:59:31 | [diff] [blame] | 45 | |
| 46 | - All DevTools commits: [View the log] or follow [@DevToolsCommits] on Twitter |
| 47 | - [All open DevTools tickets] on crbug.com |
| 48 | - File a new DevTools ticket: [new.crbug.com](https://bugs.chromium.org/p/chromium/issues/entry?labels=OS-All,Type-Bug,Pri-2&components=Platform%3EDevTools) |
| 49 | - Code reviews mailing list: [[email protected]] |
| 50 | - [@ChromeDevTools] on Twitter |
| 51 | - Chrome DevTools mailing list: [groups.google.com/forum/google-chrome-developer-tools](https://groups.google.com/forum/#!forum/google-chrome-developer-tools) |
Yang Guo | 4fd355c | 2019-09-19 08:59:03 | [diff] [blame] | 52 | |
| 53 | [[email protected]]: https://groups.google.com/a/chromium.org/forum/#!forum/devtools-reviews |
Paul Lewis | 2906222 | 2021-07-07 08:56:50 | [diff] [blame] | 54 | [View the log]: https://chromium.googlesource.com/devtools/devtools-frontend/+log/main |
Yang Guo | 4fd355c | 2019-09-19 08:59:03 | [diff] [blame] | 55 | [@ChromeDevTools]: http://twitter.com/ChromeDevTools |
| 56 | [@DevToolsCommits]: http://twitter.com/DevToolsCommits |
Mathias Bynens | 1ff270d | 2020-06-22 08:59:31 | [diff] [blame] | 57 | [All open DevTools tickets]: https://bugs.chromium.org/p/chromium/issues/list?can=2&q=component%3APlatform%3EDevTools&sort=&groupby=&colspec=ID+Stars+Owner+Summary+Modified+Opened |
Tim van der Lippe | 4adb513 | 2019-11-01 11:45:45 | [diff] [blame] | 58 | [test waterfall]: https://ci.chromium.org/p/devtools-frontend/g/main/console |