An open API service indexing awesome lists of open source software.

https://github.com/negrel/neww

Negrel's Experimental Widgets for Wayland
https://github.com/negrel/neww

Last synced: 4 months ago
JSON representation

Negrel's Experimental Widgets for Wayland

Awesome Lists containing this project

README

        

# `neww` - Negrel's Experimental Widgets for Wayland

`neww` is a lightweight library for creating standalone widgets in Lua using GTK.
It enables developers to build interactive and declarative user interfaces,
similar to the [React](https://react.dev) library in JavaScript.

It is inspired by [`eww`](https://github.com/elkowar/eww) but aims to provide a more
readable and turing complete alternative.

## Features

* Declarative Syntax: Write UI components in a declarative way, making it easier
to understand and maintain your code.
* Component-based Architecture: Organize your UI into reusable and composable
components.
* React-like State Management: Manage component state efficiently using hooks.
* Luax JSX Syntax: Write your UI components using a JSX-like syntax called Luax,
providing a more concise and expressive way to define UI elements.
* Standalone Widgets

## Getting started

Run one of the example under `examples/`:

```shell
make example/bar
```

![example bar](./.github/images/bar.png)

### Running the tests

```shell
make tests
```

## Contributing

If you want to contribute to `neww` to add a feature or improve the code contact
me at [[email protected]](mailto:[email protected]), open an
[issue](https://github.com/negrel/neww/issues) or make a
[pull request](https://github.com/negrel/neww/pulls).

## :stars: Show your support

Please give a :star: if this project helped you!

[![buy me a coffee](.github/images/bmc-button.png)](https://www.buymeacoffee.com/negrel)

## :scroll: License

MIT © [Alexandre Negrel](https://www.negrel.dev/)