nix/readme.md
Daniel Flanagan 4be2f48d8d
All checks were successful
/ build-host (map[host:beefcake]) (push) Successful in 38s
/ build-host (map[host:dragon]) (push) Successful in 55s
/ build-host (map[host:flipflop]) (push) Successful in 46s
/ build-host (map[host:foxtrot]) (push) Successful in 51s
/ build-host (map[host:router]) (push) Successful in 2m44s
/ build-devshell (push) Successful in 20s
/ flake-check (push) Successful in 3m53s
fix(#19): readme and docs
2025-03-20 14:04:21 -05:00

44 lines
1.5 KiB
Markdown

<div align="center">
<h1>
<img width="100" src="lib/images/Nix_snowflake_lytedev.svg" /> <br>
Nix for <code>lytedev</code>
</h1>
[![pre-merge status](https://git.lyte.dev/lytedev/nix/badges/workflows/pre-merge.yaml/badge.svg)](https://git.lyte.dev/lytedev/nix/actions?workflow=pre-merge.yaml)
Desktop - Laptop - Servers - Routers - Packages - Templates
</div>
# Details
I aim for declaring everything where possible, but I definitely break the rules
if it's convenient enough and try to write it down when I do so. I also don't
like repeating myself in configuration. I am mostly focused on being pragmatic
and getting things done and doing so in a way that makes it easy to keep doing
so (maintainability), but I also occasionally fall into experimenting with big
refactors of the code for no real gain.
## Layers
- Common defaults (machines that I might not interact with at all or only
rarely, such as backup targets)
- Machines that I interact with only remotely (`shell` class)
- Machines that I interact with directly, such as a laptop or my desktop
workstation (`desktop` class)
## Notable Links
- [Set of NixOS modules](./lib/modules/nixos/default.nix)
- [Home router module](./lib/modules/nixos/router.nix)
- [Set of Home Manager modules](./lib/modules/home/default.nix)
- [NixOS hosts](./packages/hosts/default.nix)
- [Desktop workstation](./packages/hosts/dragon.nix)
- [Primary laptop](./packages/hosts/foxtrot.nix)
- [Server](./packages/hosts/beefcake.nix)
- [Router](./packages/hosts/router.nix)
# Docs
See [lib/doc](./lib/doc/).