LightHouseSoftware / beamui

[WIP] Web-inspired declarative desktop UIs in the D language
Boost Software License 1.0
0 stars 0 forks source link

beamui

beamui is a complete rewrite of dlangui - the rich widget toolkit, written entirely in the D language.

API documentation

Contribution guide

The differences to dlangui

Please note that the library is unstable until v1.0, and minor versions may and will break API and old concepts.

Main features

Things that are under development:

This library aims to stay fairly simple and not to compete with Flutter, Avalonia, or Qt. There is no webview, no support for gestures, camera or microphone devices, no utilities for networking. I can only recommend to search for separate packages for your concrete case. Also, the library is not thread safe - all UI operations should perform in a single thread.

Build Requirements

You will need dub package manager, dmd or ldc compiler. Other compilers were not tested. Visit dlang download page for various installation methods.

Supported compiler versions are dmd ≥ 2.086, ldc ≥ 1.16.

Dependencies

pixman sdl2 x11 xext are the external dependencies. Not all configurations require them, but it's simpler to just install them all at once.

If you develop for 32-bit target, install respective 32-bit packages, e.g. on apt by adding :i386 after their names.

Ubuntu

sudo apt install libpixman-1-dev libsdl-dev libx11-dev libxext-dev

Arch Linux

sudo pacman -S --needed pixman sdl2 libx11 libxext

macOS

brew install pixman sdl2

Windows

Necessary dlls are shipped with the toolkit. dub automatically copies them into the app build folder.

To build 32-bit apps on Windows, use dub option --arch=x86_mscoff. OPTLINK is not supported anymore.

Quick Guide

Clone the repository (or download zip and unpack it):

git clone https://github.com/dayllenger/beamui.git
cd beamui

Run some examples:

dub run :basic
dub run :canvas
dub run :css