Files

T

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

* Docs updates

- New test suites doc (how to run tests)
- New WebUI Frontend doc (basic introduction to Brave's different stack)
- Patches points to best practices
- bug fix in claude code skills doc
- Adjust docs/README.md to prioritize the index
- Preflight skill addition of missing test suites

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

best-practices

[Rewards] Make gate3 URL environment-aware via CLI switches (#34801 )

2026-04-14 23:05:38 +05:30

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

…

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

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

…

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.