Primary sources & further reading

V8pedia is a map; the source is the territory. This page collects the primary sources — the actual code and official docs — so you can verify everything here and keep reading past where this site stops.

::: warning Unofficial V8pedia is an unofficial community project. Nothing here is authoritative. When this site and the sources below disagree, the sources are right. :::

The pinned source tree

Every source link on this site points at one frozen commit, so the links never rot and the line numbers stay aligned:

Commit: fb8be11de054d542bb91e11654f839e7e718b363 (the main tip on 2026-06-02).
GitHub mirror (used for permalinks): github.com/v8/v8
Canonical repository: chromium.googlesource.com/v8/v8
Live main (will differ from the pin): chromium.googlesource.com/v8/v8/+/refs/heads/main

To read the current code, replace the commit hash in any permalink with main (on the googlesource mirror) — but expect drift from what's described here.

The directories that own each subsystem

A contributor's mental index of the tree, mapped to V8pedia sections:

Directory	Owns	V8pedia
`src/parsing/`	scanner, parser, preparser	Parser
`src/ast/`, `src/zone/`	AST, zone allocator	Parser
`src/interpreter/`	Ignition: bytecode, generator, handlers	Ignition, Bytecode
`src/baseline/`	Sparkplug baseline JIT	Sparkplug
`src/maglev/`	Maglev mid-tier compiler	Maglev
`src/compiler/`	TurboFan (Sea of Nodes, pipeline)	TurboFan
`src/execution/`	isolate, tiering manager	Isolates, Feedback
`src/deoptimizer/`	deoptimization	Deopt
`src/ic/`	inline caches, stub cache	Inline caches
`src/objects/`	Map, descriptors, feedback vector, SFI	Map, ICs
`src/heap/`	Orinoco GC	GC
`src/builtins/`, `src/torque/`, `src/codegen/`	builtins, Torque, CSA	Builtins
`src/snapshot/`	startup & context snapshots	Isolates
`src/sandbox/`	the V8 sandbox	Sandbox
`src/flags/flag-definitions.h`	every runtime flag + default	Feedback
`src/d8/`	the d8 developer shell	d8

Official documentation

v8.dev — the official site; the docs and blog are the canonical source for design rationale. Especially relevant: posts on Ignition, Sparkplug, Maglev, TurboFan, Orinoco, pointer compression, and the sandbox.
Building V8 and d8 — to build and experiment. See our build and d8 pages.
Torque docs — for contributing builtins.
V8 design docs and the public design-doc folder linked from there — deeper than any third-party writeup.

How to verify a claim on this site

Click the permalink next to the claim.
Read the surrounding code — not just the quoted lines.
Cross-check the current behavior by swapping the commit for main.
Confirm dynamic behavior empirically in d8 with the relevant --trace-* flag.
If it's wrong or stale, that's the most valuable thing you can report.

Contributing to V8 itself

V8 development happens on Gerrit (chromium-review.googlesource.com), not GitHub pull requests (GitHub is a read-only mirror). Start from v8.dev/docs/contribute. The path this site aims to put you on: read a subsystem here → read its directory above → build with gm.py → experiment in d8 → pick up a bug.