dotfiles/.zsh/README.md

.zsh

This directory contains a modularised Zsh configuration. The shell environment is broken down into distinct, numbered files to enforce a strict and predictable execution order during the startup sequence.

CORE INITIALISATION

• .zshrc: The primary interactive shell entry point that sources the subsequent configuration modules.
• 00-umask.zsh: Defines default file creation permissions.
• 01-path.zsh: Constructs the $PATH variable and defines executable routes for the system.
• 02-options.zsh: Configures core Zsh behaviour and shell directives via setopt.

ENVIRONMENT AND STATE

• 03-history.zsh: Configures command history logging, file size limits, and retention behaviour.
• 04-env.zsh: Exports global environment variables required by the system and user applications.
• 05-completion.zsh: Initialises the Zsh completion system (compinit) and configures tab-completion behaviour.

EXTENSIONS AND WORKFLOW

• 06-plugins.zsh: Loads shell extensions, syntax highlighting, and prompt integrations.
• 07-binds.zsh: Defines custom keyboard shortcuts and configures input handling (such as vi-mode bindings).
• 08-aliases.zsh: Maps custom command shortcuts and overrides for daily utilities.

SCRIPTING AND LOGIC

• 09-functions.zsh: The initialisation script for loading user-defined shell functions.
• .functions: A directory containing discrete, standalone shell scripts and complex logical functions sourced into the environment.