# [debugger.html][website]

[website]: http://firefox-dev.tools/debugger.html/

[![slack-badge]][slack] ![][ci-status] [![npm-version]][npm-package] [![PRs Welcome]][make-a-pull-request]

debugger.html is a hackable debugger for modern times, built from the ground up using [React] and [Redux]. It is designed to be approachable, yet powerful. And it is engineered to be predictable, understandable, and testable.

[Mozilla] created this debugger for use in the [Firefox] Developer Tools. And we've purposely created this project in GitHub, using modern toolchains. We hope to not only to create a great debugger that works with the [Firefox][firefox-rdp] and [Chrome][chrome-rdp] debugging protocols but develop a broader community that wants to create great tools for the web.

![debugger-screenshot]

## Table of Contents

* [Quick Setup](#quick-setup)
* [Next Steps](#next-steps)
* [Getting Involved](#getting-involved)
* [Documentation](#documentation)
* [Discussion](#discussion)
* [License](#license)

### Quick Setup

> Or take a look at our detailed [getting started][getting-started] instructions.

```bash
curl -o- -L https://yarnpkg.com/install.sh | bash -s
git clone https://github.com/devtools-html/debugger.html.git

cd debugger.html
yarn
yarn start
# Go to http://localhost:8000
```

#### Next Steps

* [`/claim`][cl] an [available] issue. If you get stuck, we'd be happy to [help].
* Do our getting started activity [debugging the debugger][first-activity]
* Read the [app overview][app-overview] or [contributing][contributing] guidelines
* Watch a [video][getting-started-screencast] on contributing to the Debugger. Or [listen][changelog] to a podcast about the project.
* Go to the [features][tracking] board to see what we're working on

### Getting Involved

This is an open source project and we would love your help. We have prepared a [contributing] guide to help you get started.

If this is your [first PR][make-a-pull-request] or you're not sure where to get started,
say hi in [slack] and a team member would be happy to mentor you.

We strive for collaboration with [mutual respect for each other][contributing]. Mozilla also has a set of [participation guidelines] which goes into greater detail specific to Mozilla employees and contributors.

Or, perhaps you have found a vulnerability in the debugger and want to report it? in that case, take
a look at [how we handle security bugs over][vulnerabilities], and open a bug at [Bugzilla][bugzilla] so we can track it while keeping users safe!

### Development Guide

We strive to make the Debugger as development friendly as possible. If you have a question that's not answered in the guide, ask us in [slack]. We also :heart: documentation PRs!

|                        |                                             |
| :--------------------: | :-----------------------------------------: |
|        [Themes]        |       theming changes for light, dark       |
| [Internationalization] | using or adding a localized string _(l10n)_ |
|        [Prefs]         |        using or adding a preferences        |
|         [Flow]         |   flow best practices and common gotchas    |
|       [Logging]        |      tips for logging redux and client      |
|       [Testing]        |       unit and integration test tips        |
|       [Linting]        |          css, js, markdown linting          |
|       [Configs]        |    how to use debugger settings locally     |
|    [Hot Reloading]     |      steps for enabling hot reloading       |

### Documentation

Looking for a place to find our documentation? you can find them
[here][docs]!

Our [Weekly updates][weekly-updates] are also posted!

### Discussion

Say hello in [slack] or in the [#devtools-html][irc-devtools-html] channel on irc.mozilla.org.

* **Community Call**: Every Tuesday at 3pm EST and Thursday at 12pm EST. [Join the Hangout][community-call]
* **DevTools Call**: Every Tuesday at 12pm EST. [Join the DevTools Vidyo][vidyo] Meeting Notes [Google Docs][google-docs]
* **Pairing**: Ask in [slack] and you'll either find someone or be able to schedule a time for later.

### License

[MPL 2](./LICENSE)

[react]: https://facebook.github.io/react/
[redux]: http://redux.js.org/
[mozilla]: https://www.mozilla.org/
[firefox]: https://www.mozilla.org/firefox/
[firefox-rdp]: https://wiki.mozilla.org/Remote_Debugging_Protocol
[chrome-rdp]: https://chromedevtools.github.io/debugger-protocol-viewer/1-2/
[slack-badge]: https://devtools-html-slack.herokuapp.com/badge.svg
[slack]: https://devtools-html-slack.herokuapp.com/
[debugger-screenshot]: https://shipusercontent.com/47aaaa7a6512691f964101bfb0832abe/Screen%20Shot%202017-08-15%20at%202.34.05%20PM.png
[ci-status]: https://circleci.com/gh/devtools-html/debugger.html.svg??&style=shield
[npm-version]: https://img.shields.io/npm/v/debugger.html.svg
[npm-package]: https://www.npmjs.com/package/debugger.html
[prs welcome]: https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square
[make-a-pull-request]: http://makeapullrequest.com
[getting-started]: ./docs/getting-setup.md
[contributing]: ./CONTRIBUTING.md
[getting-started-screencast]: ./docs/videos.md
[available]: https://github.com/devtools-html/debugger.html/labels/available
[app-overview]: ./docs/debugger-html-react-redux-overview.md
[first-activity]: ./docs/debugging-the-debugger.md
[tracking]: https://github.com/devtools-html/debugger.html/projects/10
[help]: ./docs/local-development.md#getting-help
[participation guidelines]: https://www.mozilla.org/en-US/about/governance/policies/participation/
[irc-devtools-html]: irc://irc.mozilla.org/devtools-html
[community-call]: https://appear.in/debugger.html
[devtools-call]: https://wiki.mozilla.org/DevTools
[bugzilla]: https://bugzilla.mozilla.org/query.cgi
[vulnerabilities]: https://www.mozilla.org/en-US/about/governance/policies/security-group/bugs/
[vidyo]: https://v.mozilla.com/flex.html?roomdirect.html&key=n9vJUD3L1vRMHKQC5OCNRT3UBjw
[changelog]: https://changelog.com/podcast/247
[docs]: https://devtools-html.github.io/debugger.html/docs/
[weekly-updates]: https://devtools-html.github.io/debugger.html/docs/updates
[configs]: ./docs/local-development.md#configs
[hot reloading]: ./docs/local-development.md#hot-reloading-fire
[themes]: ./docs/local-development.md#themes
[internationalization]: ./docs/local-development.md#internationalization
[prefs]: ./docs/local-development.md#prefs
[flow]: ./docs/local-development.md#flow
[logging]: ./docs/local-development.md#logging
[testing]: ./docs/local-development.md#testing
[linting]: ./docs/local-development.md#linting
[google-docs]: https://docs.google.com/document/d/146p7Y8Ues_AKjj4ReWCk6InOPWe3C3Koy6EQ1qnYKNM/edit
[cl]: ./docs/issues.md#claiming-issues