Architecture

​

Repository structure

modules/
  nixos/          # NixOS system-level modules (~29 modules)
  home/           # Home Manager user-level modules (~31 modules)
  generic/        # Shared modules imported by both nixos and home
packages/         # Custom Nix packages (hyprmon, plymouth-marchyo-theme)
overlays/         # Nixpkgs overlays (vicinae, noctalia, worktrunk)
tests/            # Evaluation-based test suite
templates/        # Flake templates (workstation)

​

Module organization

​

NixOS modules (modules/nixos/)

• options.nix — All marchyo.* option definitions
• default.nix — Import list for all NixOS modules (order matters for some)
• desktop-config.nix — Feature flag cascading (desktop enables media, office, etc.)
• defaults.nix — Default application management
• keyboard.nix — Layout normalization and XKB configuration
• fcitx5.nix — Input method engine configuration
• input-migration.nix — Assertions for removed marchyo.inputMethod.* options

​

Home Manager modules (modules/home/)

{ config, lib, osConfig ? {}, ... }:
let
  cfg = osConfig.marchyo or {};
in
{ ... }

​

Generic modules (modules/generic/)

​

Module patterns

​

Standard NixOS module

{ config, lib, pkgs, ... }:
let
  cfg = config.marchyo;
in
{
  config = lib.mkIf cfg.feature.enable {
    # configuration here
  };
}

​

Key Nix functions

​

Feature flag cascading

config = lib.mkIf cfg.desktop.enable {
  marchyo.office.enable = lib.mkDefault true;
  marchyo.media.enable = lib.mkDefault true;
};

​

Cross-module data flow

1. options.nix — Defines marchyo.keyboard.layouts accepting strings or attrsets
2. keyboard.nix — Normalizes layouts (string "us" → { layout = "us"; variant = ""; ime = null; }) and sets XKB config
3. fcitx5.nix — Reads normalized layouts, detects IME addons needed, generates fcitx5 config
4. modules/home/keyboard.nix — Extracts layout data into home.keyboard for Hyprland
5. modules/home/hyprland.nix — Reads osConfig.marchyo.graphics for GPU env vars and keyboard from home.keyboard

​

Flake inputs