Skip to content

zmono - Monolithic Framework Bundle Compiler

Builds a monolithic bundle containing all ZSHAND framework components into a single compiled .zwc file. Unlike zfull, this bundle contains only framework code — no user configuration.

Overview

zmono concatenates startup, shared_functions, core, functions, widgets, hooks, and private_functions into one file, then compiles it to bytecode at $ZSHAND/.compiled/zshand-all.zwc. This is faster than loading individual directory bundles but slower than zfull (which also includes user config).

When to use: When you want optimized framework loading but prefer user config to load separately, or when debugging user config issues.

Usage

zmono

Options

  • -h, --help: Show help message

Examples

# Build monolithic framework bundle
zmono

# Enable at startup by adding to env.zsh
export ZSHAND_USE_MONOLITHIC=1
exec zsh

What It Does

  1. Compiles individual directory bundles if any are missing
  2. Concatenates all framework components in dependency order
  3. Compiles the combined source to .zwc bytecode
  4. Places the bundle at $ZSHAND/.compiled/zshand-all.zwc

Dependencies

  • Required: ZSHAND framework directory structure
  • Required: build/compile_single_directory.zsh, build/compile_monolithic.zsh

See Also

  • zfull — Full bundle with user config (faster startup)
  • zr — Standard incremental rebuild
  • zfresh — Clean rebuild with shell restart