Skip to content

Home

Jump to bottom
Christopher L Fox Junior edited this page May 4, 2026 · 5 revisions

KibaOS Wiki

KibaOS Banner

Build Status License Status

Welcome to the official KibaOS Wiki. This document provides an exhaustive deep-dive into the internals, design philosophy, and technical implementation of KibaOS.

🏗️ Architecture & Core Components

Base System

KibaOS is built upon the Ubuntu Resolute

  • Kernel: CachyOS Kernel (optimized for desktop responsiveness and performance).
  • Init System: Systemd.
  • Display Server: Wayland (default) with X11 fallback.
  • Bootloader: ISOLINUX (exclusively, for a simplified and branded boot experience).

Extreme Minimization

The system undergoes aggressive footprint reduction during the build process:

  • Documentation Stripping: All /usr/share/doc, /usr/share/man, and /usr/share/info files are removed.
  • Locale Optimization: Only en and en_US locales are preserved.
  • Dependency Pruning: Meta-packages like kde-plasma-desktop are avoided in favor of a minimal plasma-desktop + plasma-workspace combination.
  • Binary Compression: ELF binaries are compressed using UPX (best mode, excluding critical system components) to reduce disk usage.

🎨 User Experience (UX) & Design

Visual Identity

KibaOS follows the Dracula color palette for system-wide visual consistency.

Component Choice
Desktop Environment KDE Plasma 6.3
Global Theme Ant-Dark
Color Scheme Dracula
Icon Theme Kora
Cursor Theme Vimix
System Font Inter
Monospace Font JetBrains Mono

Shell Experience

Zsh is the default shell for all users, including root.

  • Prompt: Starship (Pre-configured with a minimalist Dracula theme).
  • Plugins: Autosuggestions and Syntax Highlighting are enabled by default.
  • Modern CLI Tools:
    • nala (Beautiful frontend for apt)
    • eza (Modern ls replacement)
    • bat (Syntax-highlighting cat)
    • fastfetch (System information)
    • btop (Resource monitor)
    • ripgrep (Fast search)
    • fd-find (Fast file finder)
    • tealdeer (tldr implementation)

Boot & Branding

  • Plymouth: Custom "kibaos-spinner" theme with a Dracula-themed progress bar and logo.
  • Boot Menu: Branded ISOLINUX menu with plain-English options for beginners.

📦 Software Management

KibaStore

KibaOS features KibaStore, which is a native build of Bazaar. It serves as a user-friendly frontend for managing Flatpaks without the overhead of heavy software centers.

Repositories & Packages

  • Ungoogled Chromium: Provided via OBS (Open Build Service) repository.
  • Flatpak: Integrated by default with the Flathub remote.
  • Nala: Configured as the primary package manager frontend with system-wide aliases (apt -> nala).

🛡️ Security & Compliance

California AADC (AB 2273)

KibaOS includes a custom Age Verification module within the Calamares installer to comply with the California Age-Appropriate Design Code Act.

  • Implementation: A Python-based view module in the installer.
  • Privacy: Data is stored locally only at /etc/kibaos/age-verify and is never transmitted to external servers.

🚀 Build Infrastructure

KibaOS uses a highly automated CI/CD pipeline.

Build Pipeline

  1. Tooling: Built using live-build (lb).
  2. Environment: Docker container running Debian Trixie.
  3. Orchestration: GitHub Actions (.github/workflows/kiba.yml).
  4. Caching: Extensive stage caching (bootstrap, chroot, rootfs, binary) for fast builds.

Image Optimization

  • Compression: The SquashFS filesystem is repacked with Zstd (compression level 19) for maximum space efficiency and decompression speed.
  • Initramfs: Configured with zstd -19 for faster boot times.

🛠️ Build Locally

To reproduce the build environment on your own machine:

git clone https://github.com/WolfTech-Innovations/Kiba
cd Kiba
docker run --rm --privileged \
  -v "$PWD:/w" \
  -e RUN_NUM=local \
  debian:trixie \
  /w/build.sh

Important

Ensure you have at least 15 GB of free space and a working internet connection.

🤝 Community & Support

Note

KibaOS is a community-driven project. Contributions in the form of code, documentation, or bug reports are highly encouraged.

Clone this wiki locally