Skip to content
codingncaffeine edited this page Sep 5, 2026 · 8 revisions

Sashfold

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.

Getting started

  • 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

What works today

  • 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

Measured

  • 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

Design decisions

  • 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 and tools

  • Testing — unit tests, reference tests and their goldens, shell scripts, the WPT runner, fuzzers, CI
  • Scripting the shell — the --script command reference

Clone this wiki locally