knstrktr

knstrktr is …

knstrktr does…

Getting Started

In any scenario, you need to recursively clone the knstrktr repository:

git clone --recursive https://codeberg.org/aartaka/knstrktr

(Recursion is necessary to get all the dependencies together with knstrktr. You can ignore this step if you prefer rolling your own Lisp libraries.)

Executable user setup

Using knstrktr as an executable for building UIs requires building knstrktr itself first.

# Make an executable, knstrktr
make all
# Install globally
sudo make install
# Install locally instead
make install DESTDIR=~/.local

And then you can just invoke knstrktr and feed it some commands:

$ knstrktr
title My new UI!
button hello command="echo 'Hello, World!'" output=shell Greet the world!
open

Pressing the button in the opened window will print "Hello, World!" back in the terminal.

Contributor/developer setup

Having recursively cloned the repository, you can run

• an Emacs-friendly development server: make slynk or make swank
• REPL with all the dependencies and knstrktr preloaded: make repl
• tests: (asdf:test-system "knstrktr") or run make check from CLI.

API