Files

T

Brian R. Bondy b3d33bcc98 Add best practice: factory return value must be stable across the browser session (#36217 )

Adds ARCH-072 to docs/best-practices/architecture.md. A KeyedServiceFactory
may only return nullptr based on session-stable attributes (profile type,
buildflags, base::Feature). Gating creation on user-toggleable prefs forces
restarts and was repeatedly flagged in PR reviews.

2026-05-06 13:52:15 -04:00

best-practices

Add best practice: factory return value must be stable across the browser session (#36217 )

2026-05-06 13:52:15 -04:00

chrome/browser/ui/tabs

[Tree Tabs] Support tab groups in tree tab strip (#34826 )

2026-03-24 11:18:48 +01:00

containers

Support contained tabs session restore and sync. (#33313 )

2026-03-10 19:20:50 +07:00

images

readme migrate from b-b (#34734 )

2026-03-23 09:27:39 -07:00

adapting_chromium_tests.md

…

android_settings_search_index.md

Android settings search indexes (#34576 )

2026-03-12 23:20:56 +02:00

best_practices.md

Add best practices doc for handling upstream docs (#34864 )

2026-03-20 12:22:23 -04:00

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

Add crypto.md to docs/ (#35637 )

2026-04-17 12:38:09 -07:00

devtools_frontend_patching.md

…

git_configuration.md

…

gni_sources.md

Convert sources.gni codeowner to semgrep (#32229 )

2025-11-17 14:01:26 -07:00

ignoring_format_checks.md

…

keyed_services.md

[cr145][Android] Replace JavaParamRef -> JavaRef

2026-01-29 13:40:24 -05:00

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

Add link to plaster best practices in plaster.md (#34517 )

2026-03-06 13:43:03 +00:00

premium_account_privacy.md

Add detail to the premium account token docs (#35503 )

2026-04-14 15:21:15 -04:00

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

Add --update-crate flag to update a single vendored tool crate (#34929 )

2026-04-03 10:40:38 +13:00

ship_a_file_to_all_clients.md

…

siso_customization.md

siso: Include linux toolchain build dependencies. (#32882 )

2025-12-22 19:54:36 +01:00

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

[docs]: Add a basic overview of frontend testing (#29795 )

2026-02-26 22:59:16 +00:00

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.