2021-02-14 02:38:20 +00:00
|
|
|
# Overlays
|
|
|
|
Writing overlays is a common occurence when using a NixOS system. Therefore,
|
|
|
|
we want to keep the process as simple and straightforward as possible.
|
|
|
|
|
|
|
|
Any _.nix_ files declared in this directory will be assumed to be a valid
|
2021-04-19 02:26:27 +00:00
|
|
|
overlay, and will be automatically imported into all [hosts](../concepts/hosts.md), and
|
2021-04-27 01:29:05 +00:00
|
|
|
exported via `overlays.<channel>/<pkgName>` _as well as_
|
2021-02-14 02:38:20 +00:00
|
|
|
`packages.<system>.<pkgName>` (for valid systems), so all you have to do is
|
|
|
|
write it.
|
|
|
|
|
|
|
|
## Example
|
|
|
|
overlays/kakoune.nix:
|
|
|
|
```nix
|
|
|
|
final: prev: {
|
|
|
|
kakoune = prev.kakoune.override {
|
|
|
|
configure.plugins = with final.kakounePlugins; [
|
|
|
|
(kak-fzf.override { fzf = final.skim; })
|
|
|
|
kak-auto-pairs
|
|
|
|
kak-buffers
|
|
|
|
kak-powerline
|
|
|
|
kak-vertical-selection
|
|
|
|
];
|
|
|
|
};
|
|
|
|
}
|
|
|
|
```
|