The Firefox debugger that works anywhere
JavaScript CSS Other
Pull request Compare This branch is 1 commit ahead, 3089 commits behind devtools-html:master.
Permalink
Failed to load latest commit information.
.github Enhancement: Add a PR template to guide contributors in what to put i… Sep 21, 2016
.storybook Extract Devtools Local Toolbox Oct 13, 2016
bin
docs update documentation package, add docs to utils (#1058) Oct 31, 2016
packages (WIP) fix some issues with watch expressions (#1117) Nov 6, 2016
public Add mochitest for source tree (fixes #648) Nov 8, 2016
.babelrc Extract Devtools Local Toolbox Oct 13, 2016
.editorconfig Add basic EditorConfig file. (#589) Aug 31, 2016
.eslintignore update ignores (#1022) Oct 26, 2016
.eslintrc Add L10N support Oct 27, 2016
.flowconfig Annotate log and defer utils (#1064) Nov 2, 2016
.gitignore Fix toggling breakpoints (#984) Oct 26, 2016
.stylelintignore Extract Devtools Local Toolbox Oct 13, 2016
.stylelintrc Upgrade stylelint Sep 19, 2016
CODE_OF_CONDUCT.md add Contributor Covenant (#565) Aug 22, 2016
CONTRIBUTING.md Add a fix command to autofix js linting errors (#1131) Nov 6, 2016
LICENSE License (#332) Jul 14, 2016
README.md Fix the capitalization of "GitHub" in two files. (#1077) Nov 2, 2016
circle.yml create a downloads cache directory in circleci (#1000) Oct 26, 2016
lerna.json
mocha-runner.html Add source tabs Jun 21, 2016
package.json Add a fix command to autofix js linting errors (#1131) Nov 6, 2016
webpack.config.js Pref Source Maps with Source Maps (#879) Oct 26, 2016
yarn.lock Update yarn lockfile (#1144) Nov 8, 2016

README.md

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.

debugger-screenshot

Circle CI status npm version PRs Welcome

Getting Started

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

Linux or MacOs

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

Windows

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

  • npm install --ignore-scripts - Install dependencies
  • bash ./bin/preinstall - Run preinstall script manually
  • npm start - Start development web server
  • open http://localhost:8000 - Open in any modern browser

Now you have the debugger.html web app running, follow the instructions shown on that page to start up 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.

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