capy
capy

capy-ui/capy

MPL-2.0

๐Ÿ’ปBuild one codebase and get native UI on Windows, Linux and Web

1.7K 1.7K 63 17
11
build.zig.zon  build.zig 
View on Github  
Updated: 9:58:11 AM Sun Nov 10 2024 Size: 15634KB Created: 11:36:16 AM Wed Mar 24 2021
Dependencies:
zig-objc macos_sdk zigimg
zig  fetch  --save  git+https://github.com/capy-ui/capy

As of now, Capy is NOT ready for use in production as I'm still making breaking changes

Capy targets Zig version 0.14.0-dev.1911+3bf89f55c / 2024.10.0-mach (Nominated Zig versions) , it doesn't work on Zig 0.13.0


Introduction

Capy is a GUI library for Zig. It is mainly intended for creating applications using native controls from the operating system. Capy is a declarative UI library aiming to be easy to write for and versatile.

It has been made with the goal to empower standalone UI applications, integration in games or any other rendering process is a non-goal.

Features

  • Use Zig for frontend and backend
  • Accessibility: compatibility with almost all accessibility tools
  • Cross-platform
  • Uses the target OS toolkit
  • Cross-compilable from any platform to any other platform
  • Tiny executables - Every example's size < 2MB, which is smaller than 'hello world' in Go

Getting Started

If you're starting a new project, simply clone capy-template and follow build instructions.

Otherwise or for more information, please look in the docs.

You can ask questions and receive updates on the #capy-ui Matrix channel.

Usage

A simple application using capy:

const capy = @import("capy");
const std = @import("std");
pub usingnamespace capy.cross_platform;

pub fn main() !void {
    try capy.init();

    var window = try capy.Window.init();
    try window.set(
        capy.column(.{ .spacing = 10 }, .{ // have 10px spacing between each column's element
            capy.row(.{ .spacing = 5 }, .{ // have 5px spacing between each row's element
                capy.button(.{ .label = "Save", .onclick = @ptrCast(&buttonClicked) }),
                capy.button(.{ .label = "Run",  .onclick = @ptrCast(&buttonClicked) })
            }),
            // 'expanded' means the widget will take all the space it can
            // in the parent container
            capy.expanded(
                capy.textArea(.{ .text = "Hello World!" })
            )
        })
    );

    window.setPreferredSize(800, 600);
    window.show();
    capy.runEventLoop();
}

fn buttonClicked(button: *capy.Button) !void {
    std.log.info("You clicked the button with text {s}", .{button.getLabel()});
}

It is easy to add something like a button or a text area. The example can already be used to notice a widget's parameters are usually enclosed in anonymous structs (.{ .label = "Save" }). You can also see that simply wrapping a widget with capy.Expanded( ... ) will tell it to take all the space it can.

Contributing

Contributing can be as simple as opening an issue and detailling what bug you encountered or what feature you wish to have.
If you want to help the project more directly, you can fork the project and then create a pull request.

Supported platforms

A platform is considered supported only if it can be built to from every other OS.

Legends:

  • โœ… Working and can be cross-compile from all platforms supported by Zig
  • ๐Ÿงช Experimental
  • ๐Ÿƒ Planned

Desktop

โœ… Windows x86_64
โœ… Windows i386

๐Ÿƒ macOS M1
๐Ÿƒ macOS x86_64

โœ… Linux x86_64
โœ… Linux i386
โœ… Linux aarch64 (PinePhone, PineBook...)

โœ… FreeBSD x86_64

Mobile

๐Ÿงช Android
๐Ÿƒ iOS

Web

โœ… WebAssembly

Note: As there's no "official" GUI library for Linux, GTK 4 has been chosen as it is the one that works and can be configured on the most distros. It's also the reason Libadwaita won't be adopted, as it's meant for GNOME and GNOME only by disallowing styling and integration with other DEs.

Supported components

For now, not every platform supports the same components. So here's a list of the ones that are supported:

win32 macOS GTK Android wasm
Button โœ… โœ… โœ… โœ… โœ…
Canvas โŒ โŒ โœ… โœ… โœ…
CheckBox โœ… โŒ โœ… โŒ โŒ
Dropdown โœ… โŒ โœ… โŒ โŒ
Image โŒ โŒ โœ… โŒ โœ…
Label โœ… โœ… โœ… โœ… โœ…
Menu โŒ โŒ โŒ โŒ โŒ
Navigation โŒ โŒ โŒ โŒ โŒ
NavigationSidebar โŒ โŒ โœ… โŒ โŒ
Scrollable โœ… โŒ โœ… โŒ โŒ
Slider โœ… โŒ โœ… โŒ โœ…
Tabs โœ… โŒ โœ… โŒ โŒ
TextArea โœ… โŒ โœ… โŒ โŒ
TextField โœ… โŒ โœ… โœ… โœ…
Window โœ… โœ… โœ… โœ… โœ