Stasis is an experimental Servo-based runtime for executing a supported web
application as a controlled event system. The checked-in native and TypeScript package sources
target the 0.3.3 corrective train. They retain frozen controlled-webapp-v1 and
controlled-web-session-v1 behavior, with controlled-web-session-v1 still the default, and add
the separately selected, versioned
controlled-web-session-v2 contract.
Source version and package CI are not publication proof. v0.2.1 and
@oxhq/stasis@0.2.1 remain the last fully qualified predecessor. v0.3.0 is immutable
disqualified release evidence after its macOS anonymous-consumer failure. The immutable v0.3.1
GitHub release is also disqualified: automatic npm prepublication failed in the packed SDK's
cookie-replacement settlement, and @oxhq/stasis@0.3.1 was never published. The immutable
v0.3.2 GitHub release is likewise disqualified: its release-event macOS public-package verifier
timed out during cookie-replacement settlement before npm publication, so
@oxhq/stasis@0.3.2 was never published. Version 0.3.3 is the
stable successor only when its
exact tag, release, registry package, provenance, and anonymous public-consumer evidence exist.
Verify those public artifacts rather than inferring release status from this checkout.
A separate immutable benchmark release
measured the exact Stasis v0.3.3 product at source revision
48c5a718a9ddd63f496e45307e1484974ccf8587
on two frozen, correctness-gated workloads. Each result below is one
single-host observation using ten alternating AB/BA pairs after one untimed
warm-up per implementation.
| Frozen workload | Published observation | Fresh-host replication |
|---|---|---|
| Cypress RWA authentication, Windows 2022 CI-only bundle | Median duration: Cypress 17499.546000 ms vs Stasis 3890.592700 ms; median paired Cypress/Stasis ratio 4.479108x (raw) |
Median duration: Cypress 20974.414150 ms vs Stasis 5553.314200 ms; median paired Cypress/Stasis ratio 3.761166x (raw) |
| Crawlee deterministic 20-page crawl, Ubuntu 22.04 | Median duration: Crawlee 2195.796579 ms vs Stasis 2378.866899 ms; median paired Crawlee/Stasis ratio 0.929559x (raw) |
Median duration: Crawlee 2272.683301 ms vs Stasis 2409.138217 ms; median paired Crawlee/Stasis ratio 0.948109x (raw) |
In each run, all 20 timed RWA observations completed the complete frozen
8/8 authentication intents. That is not all 45 RWA tests, Cypress API
equivalence, or exact browser-semantic equivalence. All 10/10 crawl pairs
were exact-equivalent at 20/20 pages, and no timed failure was discarded.
Original and replication hosts and the Windows/Ubuntu tracks are not pooled;
these workload-specific exploratory observations do not support a general
speed claim. The Windows result used a qualification-only bundle and does not
add Windows to the managed release platforms. See the
replication report
and checksums.
The immutable Stasis v0.3.3 Linux x86-64 runtime dynamically loads
libEGL.so.1 during graphics initialization. On Ubuntu 22.04, install it
before using the release archive directly or through @oxhq/stasis:
sudo apt-get update
sudo apt-get install --yes --no-install-recommends libegl1The v0.3.3 archive's INSTALL.txt and NATIVE-LIBRARIES.txt omitted this
dynamically loaded prerequisite. The archive and executable bytes are
unchanged. Source builds that run ./mach bootstrap already install it.
Start with STASIS.md for the product boundary, the v0.3 controlled-session contract for the explicit v2 surface, the frozen v0.2 session contract for the default v1 session, and the v0.1 protocol for the frozen legacy methods. Build and release operators should also read the release runbook.
Servo is a prototype web browser engine written in the Rust language. It is currently developed on 64-bit macOS, 64-bit Linux, 64-bit Windows, 64-bit OpenHarmony, and Android.
Servo welcomes contribution from everyone. Check out:
- The Servo Book for documentation
- servo.org for news and guides
Coordination of upstream Servo development happens:
- Here in the Github Issues
- On the Servo Zulip
- In video calls advertised in the Servo Project repo.
For more detailed build instructions, see the Servo Book under Getting the Code and Building Servo.
- Download and install Xcode and
brew. - Install
uv:curl -LsSf https://astral.sh/uv/install.sh | sh - Install
rustup:curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh - Restart your shell to make sure
cargois available - Install the other dependencies:
./mach bootstrap - Build servoshell:
./mach build
- Install
curl:- Arch:
sudo pacman -S --needed curl - Debian, Ubuntu:
sudo apt install curl - Fedora:
sudo dnf install curl - Gentoo:
sudo emerge net-misc/curl
- Arch:
- Install
uv:curl -LsSf https://astral.sh/uv/install.sh | sh - Install
rustup:curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh - Restart your shell to make sure
cargois available - Install the other dependencies:
./mach bootstrap - Build servoshell:
./mach build
- Download
uv, andrustup- Be sure to select Quick install via the Visual Studio Community installer
- Ensure that
wingetis available. It should be preinstalled on Windows 10 1809+ and Windows 11, otherwise can bemanually installed. - In the Visual Studio Installer, ensure the following components are installed:
- Windows 10/11 SDK (anything >= 10.0.19041.0) (
Microsoft.VisualStudio.Component.Windows{10, 11}SDK.{>=19041}) - MSVC v143 - VS 2022 C++ x64/x86 build tools (Latest) (
Microsoft.VisualStudio.Component.VC.Tools.x86.x64) - C++ ATL for latest v143 build tools (x86 & x64) (
Microsoft.VisualStudio.Component.VC.ATL)
- Windows 10/11 SDK (anything >= 10.0.19041.0) (
- Restart your shell to make sure
cargois available - Install the other dependencies:
.\mach bootstrap - Build servoshell:
.\mach build
- Ensure that the following environment variables are set:
ANDROID_SDK_ROOTANDROID_NDK_ROOT:$ANDROID_SDK_ROOT/ndk/28.2.13676358/ANDROID_SDK_ROOTcan be any directory (such as~/android-sdk). All of the Android build dependencies will be installed there.
- Install the latest version of the Android command-line
tools to
$ANDROID_SDK_ROOT/cmdline-tools/latest. - Run the following command to install the necessary components:
sudo $ANDROID_SDK_ROOT/cmdline-tools/latest/bin/sdkmanager --install \ "build-tools;36.0.0" \ "emulator" \ "ndk;28.2.13676358" \ "platform-tools" \ "platforms;android-37" \ "system-images;android-37;google_apis;x86_64"
- Follow the instructions above for the platform you are building on
- Follow the instructions above for the platform you are building on to prepare the environment.
- Depending on the target distribution (e.g.
HarmonyOS NEXTvs pureOpenHarmony) the build configuration will differ slightly. - Ensure that the following environment variables are set
DE 6779 VECO_SDK_HOME(Required when targetingHarmonyOS NEXT)OHOS_BASE_SDK_HOME(Required when targetingOpenHarmony)OHOS_SDK_NATIVE(e.g.${DEVECO_SDK_HOME}/default/openharmony/nativeor${OHOS_BASE_SDK_HOME}/${API_VERSION}/native)SERVO_OHOS_SIGNING_CONFIG: Path to json file containing a valid signing configuration for the demo app.
- Review the detailed instructions at [Building for OpenHarmony].
- The target distribution can be modified by passing
--flavor=<default|harmonyos>tomach <build|package|install>.