Skip to main content

Installing Ziva

Requirements

  • Go 1.23.0+ (toolchain 1.24.5 recommended)
  • Terminal with UTF-8 support for proper pseudographics display
  • Terminal color support (optional)

Installation

Via go get

Via go mod

Add to your go.mod:
Then run:

Installation Verification

Create a simple main.go file for verification:
Run it:

Environment Setup

Locale Configuration (for non-English languages)

For correct display of non-English text, configure locales: Ubuntu/Debian:
Entware/BusyBox:

Font Configuration

For embedded systems, font configuration may be required:

Environment Variables

Ziva supports configuration via environment variables:

Project Structure

Recommended Go project structure with Ziva:

Dependencies

Ziva uses the following main dependencies:
  • Bubble Tea - foundation for TUI
  • Lip Gloss - styling and colors
  • Cobra - CLI (optional)
All dependencies are installed automatically with go get.

Next Step

Create your first TUI application