Configuration

Top-level configuration files. Most contributors never touch most of these; the ones marked "frequently edited" are the exceptions.

Package management

File	Purpose	Edited often?
package.json	Top-level workspace, scripts, root dependencies.	Sometimes.
pnpm-workspace.yaml	Lists every package in the pnpm workspace.	When adding/removing a workspace package.
pnpm-lock.yaml	Lockfile. Generated by pnpm.	Auto-updated.
.npmrc	npm-level config (registry, hoisting).	Rarely.
.pnpmfile.cjs	pnpm install hooks.	Rarely.
.nvmrc	Node.js version pin.	When bumping Node.

Each package under packages/, adev/, devtools/, dev-app/, modules/, and integration/ has its own package.json.

Build system

File	Purpose
MODULE.bazel	Bzlmod module definition.
MODULE.bazel.lock	Locked dependency graph.
.bazelrc	Bazel command-line flags applied across all invocations.
.bazelversion	Pinned Bazel version (consumed by bazelisk).
tools/defaults.bzl	Default macro flags applied to ng_module, ng_web_test_suite, etc.
tools/legacy-saucelabs/	Legacy browser CI lane configuration.
packages/*/BUILD.bazel	Per-package Bazel target definitions.
gulpfile.js	Legacy Gulp tasks (kept for a few CI helpers).

TypeScript

File	Purpose
packages/tsconfig.json	Base config for framework code.
packages/tsconfig-build.json	Build-time TypeScript config.
packages/tsconfig-test.json	Test-time config.
packages/tsec-exemption.json	Trusted-types exemptions.
tsconfig-tslint.json	Used by the tslint script.
Per-package tsconfig.json	Each package extends the base.

Linting and formatting

File	Purpose
tslint.json	Top-level tslint rules.
tools/tslint/	Custom tslint rules used by the repo.
.prettierrc	Prettier formatter config.
.prettierignore	Paths Prettier skips.
.editorconfig	Editor newline / indent defaults.
.clang-format	Used by a few generated files.

ng-dev

File	Purpose
.ng-dev/config.mjs	Top-level ng-dev config; references the rest.
.ng-dev/commit-message.mjs	Allowed commit types and scopes.
.ng-dev/format.mjs	Files to format and the formatter.
.ng-dev/pull-request.mjs	PR validation rules.
.ng-dev/release.mjs	Release branch and publish configuration.
.ng-dev/github.mjs	GitHub repo and bot info.
.ng-dev/caretaker.mjs	Caretaker dashboard config.
.ng-dev/dx-perf-workflows.yml	Configuration for the developer-experience perf workflows.
.ng-dev/google-sync-config.json	Internal Google sync mapping.

CI

File	Purpose
.github/workflows/ci.yml	Main CI matrix.
.github/workflows/pr.yml	PR validation.
.github/workflows/adev-preview-build.yml, adev-preview-deploy.yml	Docs site preview pipeline.
.github/workflows/cross-repo-adev-docs.yml	Cross-repo doc rebuild trigger.
.github/workflows/dev-infra.yml	dev-infra dependency updater.
.github/workflows/perf.yml, benchmark-compare.yml	Performance benchmarks.
.github/workflows/merge-ready-status.yml	Merge-status surfacing.
.github/workflows/assistant-to-the-branch-manager.yml	Branch manager helper bot.
.github/workflows/scorecard.yml	OSSF scorecard.
.github/workflows/google-internal-tests.yml	Trigger internal Google CI.
.github/angular-robot.yml	Bot behavior config.
scripts/ci/	Imperative CI helpers (snapshot publish, archive creation).

Testing

File	Purpose
karma-js.conf.js	Top-level Karma config used by some tests.
packages/circular-deps-test.conf.cjs	Circular-dependency test config.
tools/testing/	Shared test utilities.
packages/private/testing/	Internal useAutoTick, timeout, etc.

Issue / PR templates

File	Purpose
.github/ISSUE_TEMPLATE/	Issue template categories.
.github/PULL_REQUEST_TEMPLATE.md	PR description template.
.husky/	Git hook scripts.
.gitmessage	Conventional-commit template message.

Renovate

File	Purpose
renovate.json	Renovate dependency-update bot config.

VS Code / dev container

File	Purpose
.vscode/	Recommended extensions and settings.
.devcontainer/	Dev Container config (used by VS Code Remote and Codespaces).
.gemini/	Gemini AI assistant config.