whatisgithub

What is libvaxis?

andrewrk/libvaxis — explained in plain English

Analysis updated 2026-08-04 · repo last pushed 2026-03-10

7ZigAudience · developerComplexity · 3/5MaintainedSetup · moderate

In one sentence

A Zig library for building rich text-based terminal apps with modern features like full-color graphics, clickable links, images, and mouse support, without relying on outdated terminal databases.

Mindmap

mindmap
  root((repo))
    What it does
      Builds terminal UIs
      Detects terminal features
      No terminfo needed
    Tech stack
      Zig
      Cross-platform
    Use cases
      Terminal email client
      Git interface
      System monitor
    Levels of use
      High-level framework
      Low-level API
    Modern features
      RGB colors
      Hyperlinks
      Mouse support
      Clipboard integration

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Build a terminal-based email client with buttons, borders, and responsive layouts.

USE CASE 2

Create a git interface that runs in the terminal with mouse support and rich visuals.

USE CASE 3

Make a system monitor dashboard with clickable elements and full-color graphics.

USE CASE 4

Develop a terminal file manager with modern features like hyperlinks and images.

What is it built with?

Zig

How does it compare?

andrewrk/libvaxisata-sesli/zovasonnylazuardi/compressor
Stars7410
LanguageZigZigZig
Last pushed2026-03-10
MaintenanceMaintained
Setup difficultymoderatehardmoderate
Complexity3/54/53/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires installing the Zig toolchain and documentation with widget examples is still in early development.

No license information provided in the explanation, so rights of use are unclear.

So what is it?

Libvaxis is a toolkit for building TUI applications, that is, programs with text-based interfaces that run in your terminal, like command-line dashboards or file managers. It is written in the Zig programming language and helps developers create rich, interactive terminal apps that feel modern rather than being limited to plain text. Most terminal libraries rely on a database called "terminfo" to figure out what a terminal can do. This project takes a different approach: it asks the terminal directly what features it supports. This means it can take advantage of modern terminal capabilities like full RGB colors, clickable hyperlinks, image rendering, fancy underlines, mouse support, and even system clipboard integration without relying on a potentially outdated database. The library offers two levels of use. A high-level framework called vxfw handles common application needs for you, things like the event loop, focus management, and mouse handling. It works in a style similar to Flutter, where you build custom interface components and place them on screen. A low-level API is also available for developers who want full manual control over every cell on the screen and want to manage their own application loop. Developers building interactive tools for the command line would use this. For example, if someone wanted to build a terminal-based email client, a git interface, or a system monitor with buttons, borders, and responsive layouts, this library provides the building blocks. It runs on macOS, Windows, Linux, and other Unix-like systems. A notable design choice is the focus on modern terminal features. Rather than building for the lowest common denominator, it detects and uses advanced capabilities when available. This tradeoff means applications built with it will shine in modern terminals but may have limited functionality in very basic ones. The project's own documentation and widget examples are still in early development.

Copy-paste prompts

Prompt 1
Help me set up a new Zig project using libvaxis to create a terminal dashboard with clickable buttons and colored output.
Prompt 2
Write a basic libvaxis app that opens the terminal, draws a bordered window, and handles mouse clicks using the high-level vxfw framework.
Prompt 3
Show me how to use the low-level libvaxis API to manually control individual screen cells and run my own event loop.
Prompt 4
Build a simple terminal file explorer with libvaxis that lists files in a scrollable view and opens directories on click.
Prompt 5
Create a libvaxis terminal app that detects whether the current terminal supports RGB colors and hyperlinks, then displays the results.

Frequently asked questions

What is libvaxis?

A Zig library for building rich text-based terminal apps with modern features like full-color graphics, clickable links, images, and mouse support, without relying on outdated terminal databases.

What language is libvaxis written in?

Mainly Zig. The stack also includes Zig.

Is libvaxis actively maintained?

Maintained — commit in last 6 months (last push 2026-03-10).

What license does libvaxis use?

No license information provided in the explanation, so rights of use are unclear.

How hard is libvaxis to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is libvaxis for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.