Home/Browser DevTools/Firefox DevTools Contributor Docs
F
Firefox DevTools Contributor Docs logo

Firefox DevTools Contributor Docs

Updated: Sep 2, 2026

Firefox DevTools Contributor Docs

About Firefox DevTools Contributor Docs

Overview

Firefox DevTools Contributor Docs is the technical documentation for developers who want to contribute to Firefox's built-in developer tools. It covers everything from setting up a development environment to writing automated tests and understanding tool architecture.

This documentation is for engineers contributing to Firefox DevTools itself, not for users of the tools. It sits alongside the broader Firefox contributor documentation and provides DevTools-specific technical guidance on testing, performance, architecture, and code quality.

Key Benefits

  • Provides step-by-step guidance for setting up a Firefox development environment and submitting patches.
  • Documents multiple automated test frameworks including xpcshell, Chrome mochitests, DevTools mochitests, Node tests, and allocation tests.
  • Includes DAMP (DevTools Automated Memory/ePerformance) performance test documentation for writing and running performance tests.
  • Covers tool architecture for the Inspector, Console, Network, Storage, Memory, Debugger, Responsive Design Mode, and CSS Panel.
  • Offers guidance on React and Redux usage within the DevTools frontend codebase.
  • Documents the Remote Debugging Protocol and actor-based backend architecture.

How It Works

Contributors first set up a Firefox development environment following the general Firefox contributor setup guide. They then navigate the DevTools-specific documentation to understand tool architecture, write automated tests using frameworks like xpcshell or mochitests, and submit patches through the standard Firefox contribution workflow.

Use Cases

  • New Firefox contributors who need to set up their development environment and learn the DevTools codebase structure.
  • Experienced Mozilla engineers writing automated tests for DevTools features using xpcshell, mochitests, or Node test frameworks.
  • Performance engineers running and authoring DAMP performance tests to track DevTools memory and speed regressions.
  • Frontend developers working on the DevTools UI who need React and Redux coding guidelines specific to the project.
  • Backend engineers implementing or modifying Remote Debugging Protocol actors for Firefox DevTools.
  • Release managers and sheriffs performing recurring release tasks and performance monitoring for DevTools.

Why Choose This Product

This documentation is the official, authoritative source for contributing to Firefox DevTools. It is best suited for developers already working within or joining the Mozilla ecosystem who need technical guidance specific to Firefox's developer tools, not general web development.

Firefox DevTools Contributor Docs Pros & Cons

Strengths
  • Official Mozilla documentation for Firefox DevTools contributors
  • Covers multiple automated test frameworks (xpcshell, mochitests, Node tests)
  • Includes DAMP performance test documentation
  • Documents React and Redux guidelines for the frontend codebase
  • Covers Remote Debugging Protocol and actor architecture

Key Features

πŸ§ͺ

Automated Test Frameworks

Documents multiple test frameworks including xpcshell, Chrome mochitests, DevTools mochitests, Node tests, and allocation tests.

πŸ“Š

DAMP Performance Tests

Provides documentation for writing and running DevTools Automated Memory/ePerformance tests to track speed and memory usage.

πŸ”§

Tool Architecture Docs

Covers the internal architecture of the Inspector, Console, Network, Storage, Memory, Debugger, and Responsive Design Mode panels.

βš›οΈ

React and Redux Guidelines

Provides project-specific coding guidelines for using React and Redux within the DevTools frontend.

πŸ”Œ

Remote Debugging Protocol

Documents the backend actor system and Remote Debugging Protocol for debugging Firefox on remote devices.

πŸ§ͺ

Debugging Intermittent Failures

Offers guidance on debugging intermittent test failures and understanding Treeherder results.

πŸ“

File Structure Guide

Explains the files and directories layout of the DevTools codebase and how to add new files.

πŸ“ˆ

Telemetry and CSP Docs

Documents DevTools telemetry collection and Content Security Policy scope, issues, and fixes.

How Firefox DevTools Contributor Docs compares

Β 
Firefox DevTools Contributor Docs logo
Firefox DevTools Contributor DocsThis
Starting priceβ€”Freeβ€”Free
Pricing modelunknownFreeunknownFree
PlatformsWebWeb, WindowsmacOSWeb
Top features
  • Automated Test Frameworks
  • DAMP Performance Tests
  • Tool Architecture Docs
  • DevTools overview
  • DevTools Protocol
  • Extensions
  • DOM inspection
  • Interactive console
  • Source debugging
  • Live Style Editing
  • Console & AI Help
  • JavaScript Debugger
Ratingβ€”β€”β€”β€”