Wizard Screen Documentation

Introduction

Khedra's configuration wizard provides a streamlined, interactive way to set up your installation. Rather than manually editing the config.yaml file, the wizard walks you through each configuration section with clear explanations and validation.

User Interface Features

The wizard provides several helpful features:

  • Keyboard Navigation: Use arrow keys and shortcuts to navigate
  • Contextual Help: Press 'h' on any screen for detailed documentation
  • Editor Integration: Press 'e' to directly edit configuration files
  • Validation: Input is checked for correctness before proceeding
  • Visual Cues: Consistent layout with clear indicators for navigation options

Using the Wizard

Start the Wizard with:

khedra init

Implementation Details

The configuration wizard described in this document is implemented through a package of Go files in the pkg/wizard directory:

Core Wizard Framework

Wizard Screen Implementations

The specific wizard screens visible in the user interface are implemented in these files:

Integration with Configuration System

The wizard integrates with the configuration system through:

  • Configuration Loading: In the ReloaderFn function passed to the wizard
  • Configuration Validation: Through the validation functions for each input field
  • Configuration Saving: In the final step of the wizard workflow

The wizard framework uses a screen-based approach with forward/backward navigation, real-time validation, and contextual help, exactly as described in this document.