In their continued effort to deliver a consistent and customizable desktop experience, Linux Mint developers have announced the release of libAdapta, a new library that was born as a direct fork of libAdwaita.
While both share a common core and an identical default visual appearance, libAdapta differentiates itself by introducing support for themes and other key enhancements that are not possible in the original library due to restrictions imposed by the GNOME development model.
Why a fork?
The Mint team mentions that the reason for creating a fork libAdwaita, is due to what have you found Recurring obstacles to integrating their improvements directly in libAdwaita, which focuses exclusively on the GNOME environment guidelines and does not consider extensions or compatibility outside its ecosystem.
This led to the creation of libAdapta as a fork, which is regularly synchronized with new versions of libAdwaita to maintain compatibility, but at the same time offers the freedom to implement changes without depending on the decisions of the GNOME team.
libAdapta is libAdwaita with theme support and some extras.
Provides the same features and look and feel as libAdwaita by default.
In desktop environments that allow theme selection, libAdapta applications follow the theme and use the appropriate window controls.
libAdwaita also provides a compatibility header that makes it easy for developers to switch between libAdwaita and libAdapta without any code changes.
This strategy allows Linux Mint to evolve independently, adapting the library to the needs of its users, especially those who use desktop environments other than GNOME and value an integrated visual appearance.
Real support for themes
One of the most critical points that motivated this bifurcation is libAdwaita's refusal to offer support for custom themes, limiting itself to a single GNOME visual style. As a result, applications created with libAdwaita often look out of place in the rest of the desktop in environments like Cinnamon, Xfce, or MATE.
libAdapta solves this problem by allowing applications to inherit the GT theme style.K in use. To do this, the library detects the system's active theme and looks for a specific subdirectory (libadapta-*) that contains the appropriate styles. If this doesn't exist, the library falls back to the default libAdwaita style, ensuring compatibility.
An advantage featured by libAdapta is its binary and source code compatibility with libAdwaita, since A special header file is included that allows developers to switch from one library to another without modifying their code, making it easy to experiment with libAdapta or adopt it into existing projects without major rewrites.
If you want to create an official GNOME application, visit libAdwaita. It's the platform's official library. If you want to be listed in the GNOME Circle and be officially recognized as a GNOME application, this is the way to go.
If you want to create an application that works in GNOME, use either library. They're both the same. LibAdwaita will evolve faster. This has its advantages and disadvantages. You'll have to keep up with your code, but you'll get new features faster than if you wait for libAdapta to be rebased.
libAdwaita has been designed to closely reflect the GNOME Human Interface Guidelines (HIG) and works closely with GTK4. Its integration with the Adwaita style and its high-level components, such as lists, buttons, forms, and dialogs, gives it consistency within the GNOME environment, but also isolates it from other desktops and visual styles.
By entering libAdapta, Linux Mint brings flexibility back to the GTK ecosystem that many users and developers considered essential. The fork is not intended to compete with GNOME, but rather to restore theming capabilities to GTK4 applications while maintaining the benefits of libAdwaita.
It is worth mentioning that this first release of libAdapta is based on the libAdwaita 1.5 version, offering, as such, most of the features and support of this version.
Finally, if you are interested in knowing more about it, you can consult the details in the following link