Repository navigation
Home
codingncaffeine edited this page Sep 5, 2026
·
8 revisions
A web browser engine written from scratch — every byte — for Windows, Linux and macOS.
Sashfold is an embeddable HTML/CSS engine and a browser built first for the readable web. It is early, it is public, and it measures itself on public yardsticks. Every byte of code in a Sashfold binary is written in the repository; the operating system and the language runtime are the only things it links. That rule is The Pledge.
This wiki is the long form. The README stays short; the details live on the pages below.
- Building — the toolchain, the two compiler lanes, and the checks that gate a build
- Running Sashfold — the window, and every command-line mode with its flags
- Themes — the window's chrome is drawn from a JSON file of tokens, reloaded while it is open
- Parsing — the WHATWG HTML parser and character encodings
- Styling — CSS syntax, selectors, the cascade, stylesheets, web fonts, colors, generated content
- Layout — block and inline layout, floats, flexbox, positioning, inline-block, replaced boxes, table cells today
- Painting and text — the painter, TrueType parsing and rasterization, Sashfold Mono, images
- Networking — URLs, HTTP/1.1, TLS, cookies, the cache, downloads, the user agent string
- The shell — tabs, history, forms, selection, find, reader mode, link hints, devtools
- Not written yet — the honest list
- Measurements — html5lib, the WPT URL tests, the WPT CSS reference tests, test262, Acid1, timings
- The Sashfold 100 — a hundred pages of the live web, rendered every night and published
- The Pledge — the boundary, drawn exactly, and how it is enforced
- Why C++ — the language choice, argued
- Architecture — the pipeline from bytes to pixels, the seam between the engine and each operating system, and the JavaScript engine
- Scripting — how a page's scripts run, what they can reach, and what is not written
- Security defaults — what Sashfold will never do, and what it does by default
- Testing — unit tests, reference tests and their goldens, shell scripts, the WPT runner, fuzzers, CI
-
Scripting the shell — the
--scriptcommand reference
Getting started
What works today
Measured
Design decisions
Testing and tools