Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/gtk-flutter/libadwaita
Libadwaita's widgets for Flutter. Following Gnome HIG and available on all platforms.
https://github.com/gtk-flutter/libadwaita
adwaita flutter gtk hacktoberfest libadwaita
Last synced: 2 days ago
JSON representation
Libadwaita's widgets for Flutter. Following Gnome HIG and available on all platforms.
- Host: GitHub
- URL: https://github.com/gtk-flutter/libadwaita
- Owner: gtk-flutter
- License: mpl-2.0
- Created: 2021-08-16T17:36:29.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-04-11T20:18:29.000Z (9 months ago)
- Last Synced: 2024-05-18T22:54:17.207Z (8 months ago)
- Topics: adwaita, flutter, gtk, hacktoberfest, libadwaita
- Language: Dart
- Homepage: https://pub.dev/packages/libadwaita
- Size: 485 KB
- Stars: 234
- Watchers: 2
- Forks: 18
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-flutter-desktop - gtk - GTK+ utilities for Flutter Linux applications. (Packages)
README
# Libadwaita ❤️ Flutter
[](https://github.com/marketplace/actions/super-linter)
[](https://pub.dev/packages/libadwaita)
[](LICENSE)
[](https://github.com/prateekmedia)
Libadwaita's widgets for Flutter. Following Gnome HIG and available on all platforms.
**NOTE:** For getting colors from gtk 3.0 theme use version [`<=0.9.8+1`](https://pub.dev/packages/gtk/versions/0.9.8+1)
## Features
- Various Libadwaita widgets ported to flutter
- Some new widgets are also available, Check example for more info
- Compatible with [various packages](#additional-information)
## Usage
- This only provides widgets, for theming you should consider [adwaita](https://pub.dev/packages/adwaita) or [yaru](https://github.com/ubuntu/yaru.dart) package.
- If you want custom titlebar then you can follow the steps for that on [`libadwaita_bitsdojo`](https://pub.dev/packages/libadwaita_bitsdojo) package.
- Here is the list of widgets imported from libadwaita library : [widgets.dart](https://github.com/gtk-flutter/libadwaita/blob/main/lib/src/widgets/widgets.dart).
See the example app in the [`example`](example) folder for more info.
## Relavant Links
- [libadwaita documentation](https://gnome.pages.gitlab.gnome.org/libadwaita/doc/main/index.html#classes)
## Additional information
### **This package works great with**
[**`adwaita`**](https://pub.dev/packages/adwaita) / [**`yaru`**](https://pub.dev/packages/yaru)
For theming
### **Optional packages**
#### [**`adwaita_icons`**](https://pub.dev/packages/adwaita_icons)
For Adwaita Icons
#### [**`libadwaita_bitsdojo`**](https://pub.dev/packages/bitsdojo)
Example:
```dart
import 'package:libadwaita_bitsdojo/libadwaita_bitsdojo.dart';
AdwHeaderBar(
actions: AdwActions().bitsdojo,
//...
)
```
#### [**`libadwaita_searchbar`**](https://pub.dev/packages/libadwaita_searchbar)
Example:
```dart
import 'package:libadwaita_searchbar/libadwaita_searchbar.dart';
bool searchedTerm = '';
AdwSearchBar(
onSubmitted: (str) => setState(() => searchedTerm = str),
controller: const TextEditingController(),
//...
)
```
#### [**`libadwaita_searchbar_ac`**](https://pub.dev/packages/libadwaita_searchbar_ac)
Example:
```dart
import 'package:libadwaita_searchbar_ac/libadwaita_searchbar_ac.dart';
bool searchedTerm = '';
AdwSearchBarAc(
suggestions: const ['Hi', 'Hello'],
onSubmitted: (str) => setState(() => searchedTerm = str),
controller: const TextEditingController(),
//...
)
```
#### [**`libadwaita_nativeshell`**](https://pub.dev/packages/nativeshell )
Example:
```dart
import 'package:libadwaita_nativeshell/libadwaita_nativeshell.dart';
AdwHeaderBar(
actions: AdwActions().nativeshell(context),
//...
)
```
#### [**`libadwaita_titlebar_buttons`**](https://pub.dev/packages/titlebar_buttons)
Example:
```dart
import 'package:libadwaita_titlebar_buttons/libadwaita_titlebar_buttons.dart';
AdwHeaderBar(
controls: AdwControls().titlebarButtons(),
//...
)
```
[Classic API Docs](https://pub.dev/documentation/libadwaita/latest/)
## Contributors
*Based on [Insights](https://github.com/gtk-flutter/libadwaita/graphs/contributors) ranking and the value of commits*
- [@prateekmedia](https://github.com/prateekmedia) - Creator and Maintainer of this library
- [@simrat39](https://github.com/simrat39) - Added various widgets and Improved example app
- [@MalcolmMielle](https://github.com/MalcolmMielle) - Worked on theming side of adwaita and created CI
- [@jesusrp98](https://github.com/jesusrp98) - Added widgets like `AdwButton`, `AdwAvatar` and improved some widgets
- [@pablojimpas](https://github.com/pablojimpas) - Added `very_good_analysis` and Fixed some code
## Support the development
To sustain the development of this library we need someone who can help this library either through code or by donating to it. Donation will help us to live up in the world of unmaintained open source packages and to dedicate more time in improving this to live up to the mark. We will also add the name of the contributors or the donaters in the README section.
To donate directly you can use below link, don't forget to leave a message there:
## License
`Mozilla Public License 2.0`
TLDR;
- You are free to use [this](https://pub.dev/packages/libadwaita) package in whatever app you want,
- If you improve the package then you should submit your patches / improvements to [this](https://github.com/gtk-flutter/libadwaita) repository.