How steel-dev/steel-browser works
Main Components
a. Frontend Layer (UI):
• React-based web interface (/ui directory)
• Session management interface
• Debug console
• Session viewer
• WebSocket connections for real-time updates
b. Backend Layer (API):
• Fastify-based REST API server (/api directory)
• Multiple protocol support modules:
• CDP (Chrome DevTools Protocol)
• Selenium
• Puppeteer/Playwright integration
c. Browser Control Layer:
• Chrome browser instances
• Session management
• Extension system
• Proxy management
d. Integration Components:
• WebSocket connections
• REST API endpoints
• Browser automation protocols
Key Relationships to Highlight
• Client applications → REST API
• UI → WebSocket connections → Backend
• Backend → Browser instances
• Browser instances → External websites
• Proxy chain → Browser instances
Architectural Pattern Representation
Use a layered architecture approach:
[External Clients/UI Layer]
• ↓
[API Gateway Layer (Fastify)]
• ↓
[Service Layer]
• Session Service
• CDP Service
• Selenium Service
• ↓
[Browser Control Layer]
• ↓
[External Resources (Websites/Proxies)]
[UI Components] → [WebSocket] → [Session Management]
• ↓
[REST API] → [Protocol Handlers (CDP/Selenium)] → [Browser Manager]
• ↓
• [Chrome Instances]
• ↓
• [External Websites]
Additional Elements
• Extension system integration
• Proxy chain management
• Session recording capability
• Stealth plugin integration points
• Markdown/PDF conversion flow
Technical Details
• Port configurations (3000 for API)
• Protocol support (CDP, Selenium, Puppeteer)
• WebSocket connections for real-time updates
• Browser session management flow
• Extension loading paths
Implementation Notes
• The modular nature of the system
• Multiple protocol support
• Session isolation
• Real-time communication channels
• Resource management flows
• All major components
• Data flow directions
• Protocol boundaries
• Integration points
• Extension mechanisms
This system design should reflect Steel's architecture as a production-ready, containerized browser sandbox with emphasis on its core features: browser control, session management, proxy support, and debugging capabilities.