I am just setting up my NixOS config for the first time, and I know that it will be fairly complex. I know it will only be possible and scalable if I have sane conventions.

I have read a number of example configs, but there does not seem to be consistent conventions between them of where to store custom option declarations, how to handle enabling/disabling modules, etc. They all work, but they do it in different ways.

Are there any official or unofficial conventions/style guides to NixOS config structure, and where can I find them?

For example, should I make a lib directory where I put modules that are easily portable and reusable in other people’s configs? When should I break modules up into smaller ones? Etc. These are things that I hope to be addressed.

  • @DrGamerPhD@programming.devEnglish
    1•4 months ago

    i took the structure from vimjoyer’s video on this. i think it’s a great starting point, after which you can start experimenting with moving stuff around and borrowing from other configs as you learn how things work

    how you separate modules is really up to you; i wouldn’t overthink it too much. in my config, my modules are split into home-manager modules and system modules, like this:

    • dotfiles/modules/home-manager
    • dotfiles/modules/nixos

    then in those, i separate based either on subject (like shell stuff, music software, games) or if the config for one program is getting really big (like my alacritty or firefox configs). my layout evolved over a few months, so don’t feel as though you need to get it spot-on from the start