Truly independent web browser https://ladybird.org
Find a file
Timothy Flynn 3516a2344f LibRequests+RequestServer: Begin implementing an HTTP disk cache
This adds a disk cache for HTTP responses received from the network. For
now, we take a rather conservative approach to caching. We don't cache a
response until we're 100% sure it is cacheable (there are heuristics we
can implement in the future based on the absence of specific headers).

The cache is broken into 2 categories of files:

1. An index file. This is a SQL database containing metadata about each
   cache entry (URL, timestamps, etc.).
2. Cache files. Each cached response is in its own file. The file is an
   amalgamation of all info needed to reconstruct an HTTP response. This
   includes the status code, headers, body, etc.

A cache entry is created once we receive the headers for a response. The
index, however, is not updated at this point. We stream the body into
the cache entry as it is received. Once we've successfully cached the
entire body, we create an index entry in the database. If any of these
steps failed along the way, the cache entry is removed and the index is
left untouched.

Subsequent requests are checked for cache hits from the index. If a hit
is found, we read just enough of the cache entry to inform WebContent of
the status code and headers. The body of the response is piped to WC via
syscalls, such that the transfer happens entirely in the kernel; no need
to allocate the memory for the body in userspace (WC still allocates a
buffer to hold the data, of course). If an error occurs while piping the
body, we currently error out the request. There is a FIXME to switch to
a network request.

Cache hits are also validated for freshness before they are used. If a
response has expired, we remove it and its index entry, and proceed with
a network request.
2025-10-14 13:40:33 +02:00
.devcontainer Devcontainer: Add libtool to dependencies 2025-10-03 15:00:09 +01:00
.github CI: Inject COMMIT file into archives when missing 2025-10-14 12:47:25 +02:00
AK AK: Fix libbacktrace fallback 2025-10-10 12:46:20 +02:00
Base/res LibWeb+LibWebView+WebContent: Replace DNT with GPC 2025-09-16 10:38:20 +02:00
Documentation LibWeb/CSS: Mark list-valued properties 2025-10-04 22:57:00 +02:00
Libraries LibRequests+RequestServer: Begin implementing an HTTP disk cache 2025-10-14 13:40:33 +02:00
Meta Meta: Don't attempt to download WPT test resources from external URLs 2025-10-14 10:27:11 +01:00
Services LibRequests+RequestServer: Begin implementing an HTTP disk cache 2025-10-14 13:40:33 +02:00
Tests LibWeb: Add support for bitmap scaling in createImageBitmap() 2025-10-14 12:19:33 +02:00
Toolchain Meta: Add SPDX license identifier to ladybird.py and BuildVcpkg.py 2025-05-29 16:24:17 -04:00
UI LibWebView: Move headless clipboard management to LibWebView 2025-10-10 15:10:03 -04:00
Utilities Meta: Add COMMIT file to cpack archives 2025-10-08 14:42:09 +02:00
.clang-format Meta: Enforce newlines around namespaces 2025-05-14 02:01:59 -06:00
.clang-tidy Meta: Disable clang-tidy's const correctness checks 2025-07-08 11:04:15 -04:00
.clangd Meta: Change the default build directories to exclude "ladybird" prefix 2024-11-06 10:38:57 -07:00
.editorconfig Meta: Add .editorconfig 2022-09-10 17:32:55 +01:00
.gitattributes LibGfx: Remove support for the various "portable" image formats 2024-06-17 21:57:35 +02:00
.gitignore CMake: Add a flatpak build for org.ladybird.Ladybird 2025-07-08 11:45:32 -06:00
.gn Meta: Automatically generate a compilation database for clangd 2023-11-14 14:29:35 -05:00
.mailmap Meta: Update my e-mail address everywhere 2024-10-04 13:19:50 +02:00
.pre-commit-config.yaml Meta: Replace deprecated pre-commit stage name 2024-10-18 09:40:59 +02:00
.prettierignore LibJS: Remove using-declaration.js from .prettierignore 2025-10-09 15:49:49 -04:00
.prettierrc Meta: Move prettier config files to the root of the repository 2020-08-24 18:21:33 +02:00
.swift-format Meta: Add swift-format configuration 2024-07-30 18:38:02 -06:00
.swift-version Meta: Update swift version to 2025-06-22 2025-07-09 16:26:49 -06:00
.ycm_extra_conf.py Meta: Sort all python imports 2025-06-09 11:25:14 -04:00
CMakeLists.txt LibWebView: Enable in Windows CI 2025-08-23 16:04:36 -06:00
CMakePresets.json LibWebView: Enable in Windows CI 2025-08-23 16:04:36 -06:00
CODE_OF_CONDUCT.md Meta: Add code of conduct (from the Ruby community) 2024-10-02 09:49:52 +02:00
CONTRIBUTING.md Meta: Add Gregory Bertilson to maintainer list :^) 2025-08-21 14:20:45 +02:00
ISSUES.md Everywhere: Document use of ladybird.py over ladybird.sh 2025-05-29 16:24:17 -04:00
LICENSE Meta: Update license year 2025-02-10 11:40:57 +00:00
pyproject.toml Meta: Use "extend-select" to enable non-default python linters 2025-06-09 17:49:35 -04:00
README.md Libraries: Remove LibArchive 2024-11-25 13:37:45 +01:00
SECURITY.md Documentation: Make updates to align better with new issue template 2024-10-31 09:18:08 +01:00
vcpkg-configuration.json Meta: Add overlay port for vulkan-loader 2024-07-07 15:56:59 +02:00
vcpkg.json Vcpkg: Disable cpptrace for freeBSD 2025-10-10 12:46:20 +02:00

Ladybird

Ladybird is a truly independent web browser, using a novel engine based on web standards.

Important

Ladybird is in a pre-alpha state, and only suitable for use by developers

Features

We aim to build a complete, usable browser for the modern web.

Ladybird uses a multi-process architecture with a main UI process, several WebContent renderer processes, an ImageDecoder process, and a RequestServer process.

Image decoding and network connections are done out of process to be more robust against malicious content. Each tab has its own renderer process, which is sandboxed from the rest of the system.

At the moment, many core library support components are inherited from SerenityOS:

  • LibWeb: Web rendering engine
  • LibJS: JavaScript engine
  • LibWasm: WebAssembly implementation
  • LibCrypto/LibTLS: Cryptography primitives and Transport Layer Security
  • LibHTTP: HTTP/1.1 client
  • LibGfx: 2D Graphics Library, Image Decoding and Rendering
  • LibUnicode: Unicode and locale support
  • LibMedia: Audio and video playback
  • LibCore: Event loop, OS abstraction layer
  • LibIPC: Inter-process communication

How do I build and run this?

See build instructions for information on how to build Ladybird.

Ladybird runs on Linux, macOS, Windows (with WSL2), and many other *Nixes.

How do I read the documentation?

Code-related documentation can be found in the documentation folder.

Get in touch and participate!

Join our Discord server to participate in development discussion.

Please read Getting started contributing if you plan to contribute to Ladybird for the first time.

Before opening an issue, please see the issue policy and the detailed issue-reporting guidelines.

The full contribution guidelines can be found in CONTRIBUTING.md.

License

Ladybird is licensed under a 2-clause BSD license.