debugger.html

debugger.html

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 and Chrome Debugging Protocol but development community that can embed this debugger in your own projects with tools like NPM.

Getting Started

Here are instructions to get the debugger.html application installed and running.

Linux or MacOs

• yarn install - Install dependencies
• yarn start - Start development web server
• open http://localhost:8000 - Open in any modern browser

NOTE: :cat2: Yarn is required. We're using yarn because it is really helpful to know that we all have the same setup.

Windows

It is recommended to use Git Shell which comes with GitHub Desktop application to emulate bash on Windows.

• yarn install - Install dependencies
• yarn start - Start development web server
• open http://localhost:8000 - Open in any modern browser

NOTE: :cat2: Yarn is required. We're using yarn because it is really helpful to know that we all have the same setup.

Open the Debugger

After yarn start, the debugger will be running on http://localhost:8000. Go to http://localhost:8000 in any browser.

Now you have the debugger.html web app running, follow the instructions shown on that page to start up a debug target like a web browser or node.js.

Please read Getting Started in our CONTRIBUTING document for more detailed instructions.

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, here are some quick links to common questions.

• Reporting Bugs
• Suggesting Enhancements
• Your First Code Contribution
• Pull Requests
• Writing Code
  • Hot Reloading
  • Tests
    • Unit Tests
    • Integration Tests
    • Linting
    • Storybook

We use the up for grabs label to indicate this work is open for anyone to take. If you already know what you're doing and want to dive in, take a look at those issues.

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

Discussion

We're all on Mozilla's IRC in the #devtools-html channel on irc.mozilla.org.

License

MPL 2