Hypercube

Cloud-native development environment with vim keybindings

COPR Package Build Status

Hyprland Core Libraries

Package	Status
hyprutils
hyprlang
hyprwayland-scanner
hyprgraphics
hyprcursor
hyprland-protocols
hyprwire
aquamarine
hyprland-qt-support
glaze

Hyprland Compositor & Tools

Package	Status
hyprland
hyprlock
hypridle
hyprpaper
xdg-desktop-portal-hyprland
hyprpolkitagent
hyprtoolkit
hyprland-guiutils
uwsm

CLI Tools

Package	Status
eza
starship
lazygit
wifitui

Other

Package	Status
quickshell
regreet
livesys-scripts

Hypercube is an opinionated, ready-to-use development environment built on Universal Blue's base-main image with Fedora 43. It provides a complete Hyprland-based workflow with consistent vim keybindings across all tools and Tokyo Night theming throughout.

Features

Keyboard-First Workflow

Every tool is configured with vim keybindings out of the box:

• Fish shell with vi mode enabled
• Hyprland window management via hjkl keys
• Ghostty terminal with vim-style pane navigation
• Neovim with LazyVim as the primary editor

Desktop Environment

• Hyprland - Dynamic tiling Wayland compositor for keyboard-driven efficiency
• Quickshell - Custom shell with notifications, app launcher, and system controls

Development Tools

Pre-configured and ready to use:

• Neovim (nightly) with LazyVim, LSP, and language support
• Lazygit for interactive Git operations
• Fish shell with Starship prompt
• Ghostty GPU-accelerated terminal
• Distrobox and Podman for containerized development environments

Consistent Theming

Tokyo Night color scheme everywhere:

• GTK and Qt applications
• Terminal emulators
• Neovim and all CLI tools
• Plymouth boot animation
• ReGreet login screen
• System-wide dark mode enforced

Screenshots

Screenshots coming soon

Installation

Prerequisites

• A system running Fedora Atomic (Silverblue, Kinoite, Bazzite, Bluefin, Aurora, etc.)
• Basic familiarity with image-based operating systems

Switch to Hypercube

From your existing Fedora Atomic system:

rpm-ostree rebase ostree-unverified-registry:ghcr.io/binarypie-dev/hypercube:43
systemctl reboot

After the first reboot, you can switch to signed images for additional security:

rpm-ostree rebase ostree-image-signed:docker://ghcr.io/binarypie-dev/hypercube:43
systemctl reboot

NVIDIA drivers are included in the unified image.

Fresh Install (ISO)

Bootable ISOs are available from the GitHub Releases page or can be built locally with just build-iso.

Switching Back

rpm-ostree rebase <your-previous-image>
systemctl reboot

Resetting Configuration

Hypercube ships default configurations in /usr/share/hypercube/config/. Use the built-in commands to safely reset configs (your existing configs are backed up automatically):

# List available configs
ujust config-list

# Reset a specific app's config (e.g., hyprland)
ujust config-reset hypr

# Reset all Hypercube configs
ujust config-reset

# See differences between your config and defaults
ujust config-diff hypr

# See all differences
ujust config-diff

Backups are saved to ~/.config/hypercube-backup-<timestamp>/.

What's Included

Packages

Built on ublue-os/base-main, Hypercube includes:

Category	Packages
Compositor	Hyprland, Hyprlock, Hypridle, Hyprpaper, Hyprshot
Shell	Quickshell (notifications, launcher, system controls)
Terminals	Ghostty
Editor	Neovim (nightly)
Git Tools	Lazygit
Development	Distrobox, Podman
Gaming	Steam
Theming	Tokyo Night GTK/Qt themes
Drivers	NVIDIA (akmods), v4l2loopback

Configurations

All configurations live in /usr/share/hypercube/config/ and are symlinked to ~/.config/ on first login:

• Fish shell with vim mode and Starship prompt
• Hyprland with vim-style navigation
• Neovim with LazyVim distribution
• Ghostty with Tokyo Night colors
• GTK/Qt theming with dark mode

Documentation

• Keybindings Reference - Complete keybinding guide for Hyprland, Ghostty, and more
• Contributing Guide - Repository structure, build system, and development workflow

Community & Support

• Open an issue for bugs or feature requests
• Universal Blue Forums for general questions
• Universal Blue Discord for community chat

Acknowledgments

Hypercube is built on excellent open source projects:

• Universal Blue - Image-based desktop platform
• Hyprland - Wayland compositor
• Quickshell - Qt6/QML shell toolkit
• LazyVim - Neovim distribution
• Tokyo Night - Color scheme

License

This project follows Universal Blue licensing. See LICENSE for details.