931f17b70e
All checks were successful
ci / fast (linux) (push) Successful in 6m46s
Install BMAD workflow framework with agent commands and templates. Create product brief, PRD, project context, and architecture decision document covering networking/persistence strategy, JS engine evolution path, threading model, web_api scaling, system integration, and tab/process model. Add generated project documentation (architecture overview, component inventory, development guide, source tree analysis). Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
4.2 KiB
4.2 KiB
rust_browser — Documentation Index
Generated: 2026-03-05 | Scan Level: Deep | Workflow: document-project v1.2.0
Project Overview
- Type: Monolith (Cargo workspace, 22 crates)
- Primary Language: Rust (edition 2021, stable toolchain)
- Architecture: Layered pipeline (4 layers, strict downward dependencies)
- Project Category: Desktop Application — Web Browser Engine
Quick Reference
- Tech Stack: Rust + winit + softbuffer + custom JS engine + custom HTML/CSS parsers
- Entry Point:
crates/app_browser/src/main.rs - Architecture Pattern: Layered pipeline with arena-based data flow
- Build:
cargo build -p app_browser - Test:
just ci(full pipeline ~1 min) - Run:
cargo run -p app_browser -- <URL>
Generated Documentation
- Project Overview — Executive summary, tech stack, architecture pattern, current status
- Architecture — Layer diagram, rendering pipeline, dependency graph, threading model, data flow
- Source Tree Analysis — Annotated directory tree, critical folders, entry points
- Component Inventory — All 22 crates with key exports, display list items, CSS/JS coverage
- Development Guide — Prerequisites, build/run/test commands, common tasks, code style
Existing Documentation
Architecture & Design
- Architecture Exploration — Foundational vision, design principles, subsystem overview
- Project Structure Guide — Crate layout, dependency rules, data patterns
Testing & Conformance
- Testing Strategy — 6-tier testing approach, sanitizers, determinism
- JS Conformance Report — Test262 conformance results by feature area
- JS Feature Matrix — JavaScript feature implementation status
- Test262 Roadmap — Gap analysis and implementation plan for Test262
- External Conformance (WPT) — Web Platform Tests integration details
- WPT Known Failures — WPT failure analysis and tracking
Implementation Status
- CSS2.1 Implementation Checklist — CSS property support status
- HTML5 Implementation Checklist — HTML element/attribute support
- Known Limitations — Intentionally deferred items and trade-offs
CI/CD & Infrastructure
- Build/CI Contract — CI pipeline, policy enforcement, merge blockers
Planning
- Milestone Plan — Development milestones
- Milestone 6 Plan — Current milestone phased implementation
Investigation Reports
- Acid2 Investigation
- Google Investigation
- Moldybits Investigation
- Slashdot Investigation
- YouTube Investigation
Getting Started
- Install Rust (stable) and
just cargo build -p app_browsercargo run -p app_browser -- https://example.com- See Development Guide for full setup and workflow
For AI Agents
When working on this project, reference:
- Architecture boundaries: Architecture → Layer rules and dependency graph
- CSS changes: CSS2.1 Checklist → Update after changes
- HTML changes: HTML5 Checklist → Update after changes
- JS changes: JS Feature Matrix → Update after changes
- Testing requirements: Development Guide → Run
just ciafter every change - Known limitations: Known Limitations → Check before implementing workarounds