Skip to content
The Firefox debugger that works anywhere 💥
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci Rename repo from debugger.html to debugger (#8009) Feb 21, 2019
.github Update CONTRIBUTING.md (#8182) Apr 8, 2019
.vscode Transpile debugger modules for DevTools loader (#6220) May 7, 2018
_layouts Adding DocSearch to the site (#6022) Apr 19, 2018
assets Update debugger to MC after release 133 (#8217) May 17, 2019
bin Update debugger to MC after release 133 (#8217) May 17, 2019
configs Update debugger to MC after release 133 (#8217) May 17, 2019
dist Update debugger to MC after release 133 (#8217) May 17, 2019
docs Update debugger to MC after release 133 (#8217) May 17, 2019
flow-typed Update debugger to MC after release 133 (#8217) May 17, 2019
images Update debugger to MC after release 133 (#8217) May 17, 2019
packages Update debugger to MC after release 133 (#8217) May 17, 2019
src Update debugger to MC after release 133 (#8217) May 17, 2019
test/mochitest Update debugger to MC after release 133 (#8217) May 17, 2019
.babelrc Don't transform object spread (#7489) Dec 12, 2018
.editorconfig Add basic EditorConfig file. (#589) Aug 31, 2016
.eslintignore Transpile debugger modules for DevTools loader (#6220) May 7, 2018
.eslintrc [sync] Bug 1530441 - Enable eslint locally. r=dwalsh Feb 28, 2019
.eslintrc.jsx-a11y Use AccessibleImage component instead of img in Workers (#7639) Jan 3, 2019
.flowconfig Update debugger to MC after release 133 (#8217) May 17, 2019
.gitattributes Fix cross-configuration problems (#4475) Oct 25, 2017
.gitignore Ignore module manifest unless forced (#7281) Nov 15, 2018
.prettierignore Handle global-rewrite (Ember-related) original scope resolution (#5871) Apr 10, 2018
.remarkignore [parser] Test each set of fixtures across more build targets. (#6707) Jul 27, 2018
.remarkrc Fix remark (#2880) May 13, 2017
.stylelintignore Update debugger to MC after release 133 (#8217) May 17, 2019
.stylelintrc Update debugger to MC after release 133 (#8217) May 17, 2019
.travis.yml Update debugger to MC after release 133 (#8217) May 17, 2019
CODEOWNERS Remove jdescottes from properties file codeowners (#6918) Sep 3, 2018
CODE_OF_CONDUCT.md Update Code of Conduct to use new Reporting Guideline (#7371) Nov 29, 2018
Gemfile (WIP) Improve gh-pages (#1917) Feb 3, 2017
LICENSE License (#332) Jul 14, 2016
README.md Added Firefox Nightly CLI launch instructions (#8038) Feb 28, 2019
README.mozilla Update debugger to MC after release 133 (#8217) May 17, 2019
ROADMAP.md Improve Issue triaging process (#5580) Mar 5, 2018
_config.yml (WIP) Improve gh-pages (#1917) Feb 3, 2017
jest-test.config.js Fixes #7656 - Remove absolute positioning in directory view of source… Jan 11, 2019
jest.config.js Update debugger to MC after release 133 (#8217) May 17, 2019
mocha-runner.html Update Mocha runner Jan 13, 2017
moz.build Update debugger to MC after release 133 (#8217) May 17, 2019
package.json Update debugger to MC after release 133 (#8217) May 17, 2019
postcss.config.js Update debugger to MC after release 133 (#8217) May 17, 2019
renovate.json Prevent renovate from reopening PRs (#7906) Feb 8, 2019
webpack.config.js Update debugger to MC after release 133 (#8217) May 17, 2019
yarn.lock Update debugger to MC after release 133 (#8217) May 17, 2019

README.md

debugger

slack-badge ci-badge PRs Welcome

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 create a great debugger that works with the Firefox and Chrome debugging protocols, but also develop a broader community that wants to create great tools for the web.

debugger-screenshot

Table of Contents

Quick Setup

Or take a look at our detailed getting started instructions.

First, get a recent version of Node.js to run the debugger.

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

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

If you are having problems with setting breakpoints in the debugger, launch Firefox Nightly instead of clicking on Launch Firefox.

Next Steps

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, 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. Mozilla also has a set of participation guidelines which goes into greater detail specific to Mozilla employees and contributors.

Have you found a vulnerability in the debugger and want to report it? In that case, take a look at how we handle security bugs, and open a bug at Bugzilla so we can track the vulnerability 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 ❤️ documentation PRs!

Themes Theming changes for light, dark
Internationalization Using or adding a localized string (l10n)
Prefs Using or adding 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

Documentation

Looking for our documentation? You can find it here!

Our weekly updates are also posted!

Discussion

Say hello in Slack or in the #devtools-html channel on irc.mozilla.org.

License

MPL 2

You can’t perform that action at this time.