nixy/docs/superpowers/specs/2026-07-29-nvf-reusable-flake-design.md

NVF config en flake réutilisable

Date: 2026-07-29 Statut: Approuvé (design)

Objectif

Permettre à n'importe qui de réutiliser la configuration NVF (Neovim via nvf) de ce dépôt, de deux façons :

1. nix run — lancer le nvim standalone sans home-manager.
2. Module home-manager — importer un module dans sa propre config, qui s'adapte automatiquement à son thème stylix.

Le tout sans traîner les inputs lourds du monorepo (nixarr, blog, awesome-wallpapers, etc.), et en supportant Linux et macOS.

État actuel

• home/programs/nvf/flake.nix n'est pas un vrai flake : c'est une fonction { inputs, pkgs, system, ... } fusionnée dans les outputs du flake racine via import ./home/programs/nvf/flake.nix args.
• Elle expose déjà packages.<system>.nvim, apps.<system>.nvim et homeManagerModules.nvim, mais :
  • uniquement pour x86_64-linux (system codé en dur) ;
  • homeManagerModules.nvim importe default.nix, qui exige inputs (via inputs.nvf...) — un tiers devrait le fournir lui-même ;
  • un tiers qui consomme le flake racine tire tous les inputs lourds.
• Les hosts consomment nvf en important directement le dossier (imports = [ ../../home/programs/nvf ] → default.nix), inputs venant des extraSpecialArgs du monorepo. homeManagerModules.nvim n'est donc pas utilisé en interne aujourd'hui.
• default.nix référence config.lib.stylix.colors sans garde → un consommateur sans stylix aurait une erreur d'évaluation.

Design

1. home/programs/nvf/flake.nix → vrai flake

Remplace la fonction actuelle. Inputs minimaux, outputs multi-systèmes.

• inputs.nixpkgs.url = "github:nixos/nixpkgs/nixos-26.05" (stable)
• inputs.nvf.url = "github:notashelf/nvf"
• Systèmes : x86_64-linux, aarch64-linux, aarch64-darwin, x86_64-darwin via un helper forAllSystems (nixpkgs.lib.genAttrs).
• Liste de modules partagée : options.nix, languages.nix, picker.nix, snacks.nix, keymaps.nix, utils.nix, mini.nix.

Outputs :

• packages.<sys>.nvim (+ .default) = (nvf.lib.neovimConfiguration { inherit pkgs modules; }).neovim
• apps.<sys>.nvim (+ .default) pointant vers ${nvim}/bin/nvim
• homeManagerModules.nvim (+ .default) : { imports = [ nvf.homeManagerModules.default ./default.nix ]; } — nvf capturé depuis les inputs du flake, donc le tiers n'a rien à fournir.
• formatter.<sys> = pkgs.alejandra

2. home/programs/nvf/default.nix — découplé + garde stylix

• Signature : { config, lib, ... } — plus de inputs.

• Retirer imports = [ inputs.nvf.homeManagerModules.default ] (désormais dans le wrapper homeManagerModules.nvim du flake).

• Rendre l'override stylix conditionnel :

  vim.luaConfigRC = lib.mkIf (config ? stylix && config.stylix.enable) {
    hl-overrides = let c = config.lib.stylix.colors; in '' ... '';
  };
  

  • Avec stylix → nvim prend la palette du consommateur.
  • Sans stylix → nvim marche, thème natif nvf.

3. Flake racine (flake.nix)

• Ajouter l'input :

  nvf-config = {
    url = "path:./home/programs/nvf";
    inputs.nixpkgs.follows = "nixpkgs-stable";
    inputs.nvf.follows = "nvf";
  };
  

• Retirer la ligne (import ./home/programs/nvf/flake.nix args) du merge.

• Ré-exposer, pour garder nix run .#nvim depuis la racine :

  packages.${system}.nvim = inputs.nvf-config.packages.${system}.nvim;
  apps.${system}.nvim     = inputs.nvf-config.apps.${system}.nvim;
  

4. Hosts

hosts/laptop/home.nix, hosts/work/home.nix, hosts/server/home.nix :

# avant
imports = [ ../../home/programs/nvf ];
# après
imports = [ inputs.nvf-config.homeManagerModules.default ];

Toi et les tiers utilisez ainsi exactement le même module.

Locks

Deux flake.lock distincts : racine + home/programs/nvf/flake.lock.

Contexte	Lock qui fait foi
Toi, via le monorepo (follows)	Lock racine ; le lock du sous-flake est ignoré.
Tiers, github:.../nixos?dir=home/programs/nvf	Lock du sous-flake.
nix run ./home/programs/nvf#nvim	Lock du sous-flake.

Friction connue : le path: input est épinglé dans le lock racine. Après édition de la config nvim, faire nix flake update nvf-config (ou --update-input nvf-config) pour que le monorepo reprenne les changements.

Décisions clés (YAGNI)

• Flake dédié dans le monorepo (pas dépôt séparé) — source unique, pas de synchro à gérer.
• Garde stylix optionnelle plutôt qu'exigence dure — coût nul, évite un footgun pour les tiers non-stylixés.
• Multi-système — trivial via genAttrs, permet l'usage sur macOS.

Vérification

• nix flake check ./home/programs/nvf
• nix run ./home/programs/nvf#nvim (lance nvim standalone)
• nix flake check à la racine
• Rebuild d'un host (ex. laptop) sans régression nvim, thème stylix conservé.