Files

T

Brian R. Bondy 6f91301cb0 Add best practice CS-070: Use *.mojom-forward.h in headers (#36219 )

Add best practice: Use *.mojom-forward.h in headers

CS-070: prefer the auto-generated *.mojom-forward.h over the full
*.mojom.h bindings when a header only references mojom types as
pointers, references, or function parameters. Reduces compile times
and transitive dependencies.

Source: PR #35622 review comment by netzenbot.

2026-05-07 06:52:19 -04:00

best-practices

Add best practice CS-070: Use *.mojom-forward.h in headers (#36219 )

2026-05-07 06:52:19 -04:00

chrome/browser/ui/tabs

…

containers

…

images

…

adapting_chromium_tests.md

…

android_settings_search_index.md

…

best_practices.md

…

chromium_version_upgrade.md

…

claude_code_skills.md

Docs updates - introduce Running Tests, introduce Web UI Frontend, small fixes (#35231 )

2026-04-20 22:35:18 -07:00

cryptography.md

…

devtools_frontend_patching.md

…

git_configuration.md

…

gni_sources.md

…

ignoring_format_checks.md

…

keyed_services.md

…

patching_and_chromium_src.md

Docs updates - introduce Running Tests, introduce Web UI Frontend, small fixes (#35231 )

2026-04-20 22:35:18 -07:00

plaster.md

…

premium_account_privacy.md

…

README.md

Docs updates - introduce Running Tests, introduce Web UI Frontend, small fixes (#35231 )

2026-04-20 22:35:18 -07:00

running_test_suites.md

Docs updates - introduce Running Tests, introduce Web UI Frontend, small fixes (#35231 )

2026-04-20 22:35:18 -07:00

rust.md

…

ship_a_file_to_all_clients.md

…

siso_customization.md

…

webui_frontend.md

Docs updates - introduce Running Tests, introduce Web UI Frontend, small fixes (#35231 )

2026-04-20 22:35:18 -07:00

webui_overriding.md

…

webui_strings_explainer.md

…

webui_testing.md

…

README.md

Brave docs

This directory contains documentation for the Brave Browser. For additional resources outside this repository, go to:

brave-browser/wiki

Document Index

Checking Out and Patching

Upgrading Chromium Upgrading brave-core to a newer Chromium version.
Patching with plaster A patching engine for semantical patching of upstream Chromium.
WebUI Overriding
DevTools Frontend Patching Managing changes to the upstream project.

Tools

Claude Code Skills - Slash commands for automating common development tasks (commit, review, preflight, CI, and more).

Security and Privacy

Premium Account Privacy - How blind tokens decouple payment identity from service usage.
Cryptographic Features - Cryptographic features in Brave beyond standard Chromium encryption.

General Development

Running test suites - Selectively execute unit, browser and typescript tests.
gni notes - Brief notes on the use of source.gni files in our code base.
Rust notes - General recommendations on integrating rust code into brave-core
Adapting Chromium tests to the Brave Codebase - Suggestions on how to make chromium test work on our test targets.
Ship a File to All Clients - How to ship a file to all clients via component updater.
Git Configuration - General recommendations for setting up and optimizing your Git environment.
Ignoring Files from Format and Presubmit Checks - How to exclude files from format and presubmit checks.
Siso Customization - How we customize Siso to work for us.
WebUI Frontend - General Web UI, React, webpack overview.
WebUI Testing - Guide to creating and running *.test.ts(x) suites.
WebUI Strings Overview - Including strings in a Web UI frontend.

Creating Documentation

Important

If you add new documents, please also add a link to them in the Document Index below.

Guidelines

Markdown documents must follow the Markdown Style Guide.

Previewing changes

Locally using md_browser

# in src/brave/
npm run docs

This is only an estimate. The github view may differ.