Opal Documentation

Official guide for the Opal web browser

About Opal

Opal is a lightweight web browser focused on delivering a clean, simple, and modern browsing experience.

The project is currently under active development and continues to evolve with new features, performance improvements, and bug fixes.

Technologies Used

Opal is engineered from the ground up using a highly performant stack:

  • C Low-level and performance-critical components.
  • C++ Core browser functionality and engine structures.
  • Swift Native macOS user interface and window layers.
  • VS Code Primary internal development environment.

Development Status

Opal is experimental software. Some features may still be incomplete, and users should expect occasional instabilities while engine optimization continues.

Community feedback and core telemetry bug reports are highly valuable and directly shape our upcoming stable milestones.

Known Issues & Watchouts

History Window Freezing

Opening the native History window can occasionally cause the parent application interface controls to hang or become unresponsive.

Temporary Workaround: Force quit or restart Opal if your active instance's window frame becomes unresponsive.

Engine Status: High Priority • Currently under architectural investigation.

Reporting Bugs

If you encounter an exception or edge case while running workflows inside Opal, please structure your log with the following details:

  • Deterministic steps required to reliably reproduce the problem.
  • Your actual expected application behavior.
  • The actual observed broken execution state.
  • Your exact current Opal framework version number.
  • System environment snapshots or video recordings (if available).