webview/webview is a C++ project with 14.3k stars in the Frontend space. Tiny cross-platform webview library for C/C++. Uses WebKit (GTK/Cocoa) and Edge WebView2 (Windows).
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
A tiny cross-platform webview library for C/C++ to build modern cross-platform GUIs.
The goal of the project is to create a common HTML5 UI abstraction layer for the most widely used platforms.
It supports two-way JavaScript bindings (to call JavaScript from C/C++ and to call C/C++ from JavaScript).
[!NOTE]
Language binding for Go has moved. Versions <= 0.1.1 are available in this repository.
Platform Support
Platform
Technologies
Linux
GTK, WebKitGTK
macOS
Cocoa, WebKit
Windows
Windows API, WebView2
Documentation
The most up-to-date documentation is right in the source code. Improving the documentation is a continuous effort and you are more than welcome to contribute.
Prerequisites
Your compiler must support minimum C++11.
This project uses CMake and Ninja, and while recommended for your convenience, these tools aren't required for using the library.
Linux and BSD
The GTK and WebKitGTK libraries are required for development and distribution. You need to check your package repositories regarding which packages to install.
Use pkg-config with --cflags and --libs to get the compiler/linker options for one of these sets of modules:
gtk4 webkitgtk-6.0
gtk+-3.0 webkit2gtk-4.1
gtk+-3.0 webkit2gtk-4.0
Link libraries: dl
macOS:
Link frameworks: WebKit
Link libraries: dl
Windows:
WebView2 from NuGet.
Windows libraries: advapi32 ole32 shell32 shlwapi user32 version
BSD
Execution on BSD-based systems may require adding the wxallowed option (see mount(8)) to your fstab to bypass W^X memory protection for your executable. Please see if it works without disabling this security feature first.
Windows
Your compiler must support C++14 and we recommend to pair it with an up-to-date Windows 10 SDK.
For Visual C++ we recommend Visual Studio 2022 or later. There are some requirements when using MinGW-w64.
Developers and end-users must have the WebView2 runtime installed on their system for any version of Windows before Windows 11.
Getting Started
If you are a developer of this project then please go to the development section.
You will have a working app, but you are encouraged to explore the available examples.
An amalgamated library can be built when building the project using CMake, or the amalgamate.py script can be invoked directly.
The latter is described below.
python3 scripts/amalgamate/amalgamate.py --base core --search include --output webview_amalgamation.h src
See python3 scripts/amalgamate/amalgamate.py --help for script usage.
Non-CMake Usage
Here's an example for invoking GCC/Clang-like compilers directly. Use the main.cc file from the previous example.
Place either the amalgamated webview.h header or all of the individual files into libs/webview, and WebView2.h from MS WebView2 into libs.
Build the project on your chosen platform.
macOS
c++ main.cc -O2 --std=c++11 -Ilibs -framework WebKit -ldl -o example
Linux
c++ main.cc -O2 --std=c++11 -Ilibs $(pkg-config --cflags --libs gtk+-3.0 webkit2gtk-4.1) -ldl -o example
Windows
c++ main.cc -O2 --std=c++14 -static -mwindows -Ilibs -ladvapi32 -lole32 -lshell32 -lshlwapi -luser32 -lversion -o example
Customization
CMake Targets
The following CMake targets are available:
Name
Description
webview::core
Headers for C++.
webview::core_shared
Shared library for C.
webview::core_static
Static library for C.
Special targets for on-demand checks and related tasks:
Name
Description
webview_format_check
Check files with clang-format.
webview_reformat
Reformat files with clang-format.
CMake Options
The following boolean options can be used when building the webview project standalone or when building it as part of your project (e.g. with FetchContent).
Option
Description
WEBVIEW_BUILD
Enable building
WEBVIEW_BUILD_AMALGAMATION
Build amalgamated library
WEBVIEW_BUILD_DOCS
Build documentation
WEBVIEW_BUILD_EXAMPLES
Build examples
WEBVIEW_BUILD_SHARED_LIBRARY
Build shared libraries
WEBVIEW_BUILD_STATIC_LIBRARY
Build static libraries
WEBVIEW_BUILD_TESTS
Build tests
WEBVIEW_ENABLE_CHECKS
Enable checks
WEBVIEW_ENABLE_CLANG_FORMAT
Enable clang-format
WEBVIEW_ENABLE_CLANG_TIDY
Enable clang-tidy
WEBVIEW_ENABLE_PACKAGING
Enable packaging
WEBVIEW_INSTALL_DOCS
Install documentation
WEBVIEW_INSTALL_TARGETS
Install targets
WEBVIEW_IS_CI
Initialized by the CI environment variable
WEBVIEW_PACKAGE_AMALGAMATION
Package amalgamated library
WEBVIEW_PACKAGE_DOCS
Package documentation
WEBVIEW_PACKAGE_HEADERS
Package headers
WEBVIEW_PACKAGE_LIB
Package compiled libraries
WEBVIEW_STRICT_CHECKS
Make checks strict
WEBVIEW_STRICT_CLANG_FORMAT
Make clang-format check strict
WEBVIEW_STRICT_CLANG_TIDY
Make clang-tidy check strict
WEBVIEW_USE_COMPAT_MINGW
Use compatibility helper for MinGW
WEBVIEW_USE_STATIC_MSVC_RUNTIME
Use static runtime library (MSVC)
[!NOTE]
Checks are enabled by default, but aren't enforced by default for local development (controlled by the WEBVIEW_IS_CI option).
Non-boolean options:
Option
Description
WEBVIEW_CLANG_FORMAT_EXE
Path of the clang-format executable.
WEBVIEW_CLANG_TIDY_EXE
Path of the clang-tidy executable.
Package Consumer Options
These options can be used when when using the webview CMake package.
Linux-specific Options
Option
Description
WEBVIEW_WEBKITGTK_API
WebKitGTK API to interface with, e.g. 6.0, 4.1 (recommended) or 4.0. This will also automatically decide the GTK version. Uses the latest recommended API by default if available, or the latest known and available API. Note that there can be major differences between API versions that can affect feature availability. See webview API documentation for details on feature availability.
Windows-specific Options
Option
Description
WEBVIEW_MSWEBVIEW2_VERSION
MS WebView2 version, e.g. 1.0.1150.38.
WEBVIEW_USE_BUILTIN_MSWEBVIEW2
Use built-in MS WebView2.
Compile-time Options
These options can be specified as preprocessor macros to modify the build, but are not needed when using CMake.
C API Linkage
Name
Description
WEBVIEW_API
Controls C API linkage, symbol visibility and whether it's a shared library. By default this is inline for C++ and extern for C.
WEBVIEW_BUILD_SHARED
Modifies WEBVIEW_API for building a shared library.
WEBVIEW_SHARED
Modifies WEBVIEW_API for using a shared library.
WEBVIEW_STATIC
Modifies WEBVIEW_API for building or using a static library.
Backend Selection
Name
Description
WEBVIEW_GTK
Compile the GTK/WebKitGTK backend.
WEBVIEW_COCOA
Compile the Cocoa/WebKit backend.
WEBVIEW_EDGE
Compile the Win32/WebView2 backend.
Windows-specific Options
Option
Description
WEBVIEW_MSWEBVIEW2_BUILTIN_IMPL
Enables (1) or disables (0) the built-in implementation of the WebView2 loader. Enabling this avoids the need for WebView2Loader.dll but if the DLL is present then the DLL takes priority. This option is enabled by default.
WEBVIEW_MSWEBVIEW2_EXPLICIT_LINK
Enables (1) or disables (0) explicit linking of WebView2Loader.dll. Enabling this avoids the need for import libraries (*.lib). This option is enabled by default if WEBVIEW_MSWEBVIEW2_BUILTIN_IMPL is enabled.
MinGW-w64 Requirements
In order to build this library using MinGW-w64 on Windows then it must support C++14 and have an up-to-date Windows SDK.
Distributions that are known to be compatible:
LLVM MinGW
MSYS2
WinLibs
MS WebView2 Loader
Linking the WebView2 loader part of the Microsoft WebView2 SDK is not a hard requirement when using our webview library, and neither is distributing WebView2Loader.dll with your app.
If, however, WebView2Loader.dll is loadable at runtime, e.g. from the executable's directory, then it will be used; otherwise our minimalistic implementation will be used instead.
Should you wish to use the official loader then remember to distribute it along with your app unless you link it statically. Linking it statically is possible with Visual C++ but not MinGW-w64.
Here are some of the noteworthy ways our implementation of the loader differs from the official implementation:
Does not support configuring WebView2 using environment variables such as WEBVIEW2_BROWSER_EXECUTABLE_FOLDER.
Microsoft Edge Insider (preview) channels are not supported.
Customization options can be used to change how the library integrates the WebView2 loader.
Thread Safety
Since library functions generally do not have thread safety guarantees, webview_dispatch() (C) / webview::dispatch() (C++) can be used to schedule code to execute on the main/GUI thread and thereby make that execution safe in multi-threaded applications.
webview_return() (C) / webview::resolve() (C++) uses *dispatch() internally and is therefore safe to call from another thread.
The main/GUI thread should be the thread that calls webview_run() (C) / webview::run() (C++).
Development
This project uses the CMake build system.
Development Dependencies
In addition to the dependencies mentioned earlier in this document for developing with the webview library, the following are used during development of the webview library.
Since a browser engine is not a full web browser it may not support every feature you may expect from a browser. If you find that a feature does not work as expected then please consult with the browser engine's documentation and open an issue if you think that the library should support it.
For example, the library does not attempt to support user interaction features like alert(), confirm() and prompt() and other non-essential features like console.log().
The most recent commit recorded on webview/webview was 8 months ago, based on the GitHub push timestamp. The repository has 1.1k forks — one of the better signals of community interest.
How many stars does webview/webview have?
webview/webview has 14.3k GitHub stars — refresh the page for the live number, or check github.com/webview/webview. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
Is webview/webview open source?
Yes — webview/webview ships under the MIT license, which makes its source code freely readable (and, depending on license terms, forkable and reusable). Source: github.com/webview/webview.
What else is in the Frontend space?
webview/webview is tracked by TopGit under the Frontend category, alongside 15 GitHub-tagged topics. Trending and Topics pages list peer repositories of comparable stars and language.
What is webview/webview?
webview/webview (webview/webview) is a C++ project on GitHub. From the project's own README: Tiny cross-platform webview library for C/C++. Uses WebKit (GTK/Cocoa) and Edge WebView2 (Windows).
What language is webview/webview written in?
webview/webview is written primarily in C++. GitHub's language field is based on the largest share of bytes in the default branch.
What license does webview/webview use?
webview/webview is released under the MIT license. Always verify the LICENSE file directly on GitHub for the authoritative terms — license strings can be edited out of sync with a project's actual stance.
Where do I read more about webview/webview?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/webview/webview is the definitive source.
Read full README in the tab above.
Curious whether webview is right for you?
Let ChatGPT, Claude, or Perplexity look into it — click below and see what AI actually says about webview.