Date: January 29, 2026
Status: Ready for Windows 11 MozillaBuild compilation

Issue: Servo refactored internal crate names (compositing_traits → paint_api, layout_thread_2020 → layout_api)

Changes:

• Updated src/graphshell.rs line 28: Changed use layout_thread_2020; to use layout_api;
• Updated src/graphshell.rs line 297: Changed layout_thread_2020::LayoutFactoryImpl() to layout_api::LayoutFactoryImpl()
• Verified Cargo.toml already updated with correct crate names
• Verified src/graphshell.rs and src/compositor.rs already use paint_api imports

Status: ✅ Complete - Servo dependencies now match Cargo.toml

File: WINDOWS_BUILD.md

Contents:

• Step-by-step prerequisites (Visual Studio, Python, Perl, Git, Rust, MozillaBuild)
• Detailed build instructions
• Troubleshooting section with common issues
• Development workflow tips

Status: ✅ Complete

File: README.md

Changes:

• Simplified quick start with link to WINDOWS_BUILD.md
• Added platform-specific build instructions
• Expanded troubleshooting section
• Clarified Windows 11 requirements

Status: ✅ Complete

All Servo crates are pinned to servo/main branch:

• constellation, script, layout_api, paint_api, canvas, embedder_traits, etc.
• Supporting org crates: stylo, webrender, servo-media (pinned to specific revisions)

Status: ✅ Up-to-date with servo/main

Core dependencies are recent and stable:

• winit 0.30 (2024)
• serde 1.0 (workspace)
• log 0.4.29 (2024)
• reqwest 0.12 (2024)
• tokio 1.x (2024)
• arboard 3.4.0 (2024)

Status: ✅ All current

1. MozillaBuild (required for Windows; includes LLVM, clang for SpiderMonkey)
2. Visual Studio 2022 Build Tools with C++ workload
3. Python 3.8+ (required by Servo build scripts)
4. Perl (required by Servo build scripts)
5. Rust 1.86.0 (auto-selected from rust-toolchain.toml)

# In MozillaBuild Terminal (C:\mozilla-build\start-shell.bat)
cd /c/path/to/graphshell
cargo build --release

• First build: 15–20 minutes (compiles entire Servo stack)
• Subsequent builds: 2–5 minutes (incremental)
• Output: target/release/graphshell.exe

The codebase is ready to build on Windows 11 once MozillaBuild is installed.

The only requirement is that the user has:

1. Visual Studio 2022 Build Tools (C++)
2. Python 3.8+ in PATH
3. Perl in PATH
4. MozillaBuild installed to C:\mozilla-build

Once Graphshell builds successfully:

• Graphshell.exe launches without crash
• Address bar visible and functional
• Can type URL in address bar
• Can navigate to example.com or similar site
• Page content renders
• Can open new tabs
• Can close tabs
• Can close application gracefully
• No console errors in logs

• Run Graphshell and test the checklist above
• Identify any remaining runtime issues specific to Windows 11

• Debug webview rendering
• Test multi-tab stability
• Test download functionality
• Test keyboard/mouse input

• Only after confirmed stable tab browser
• See design_docs/GRAPH_BROWSER_MIGRATION.md for planned changes

• WINDOWS_BUILD.md — Complete step-by-step guide
• README.md — Quick reference
• design_docs/SERVO_MIGRATION_SUMMARY.md — Technical details on Servo migration
• Servo GitHub
• MozillaBuild Wiki

Built by: Graphshell maintainer
Ready for: Windows 11 x86_64
Status: ✅ Ready to build (requires MozillaBuild installation)