docs: update README.md to enhance feature descriptions and repository layout

This commit is contained in:
emmatherock
2026-07-06 00:40:19 -03:00
parent 8cc3c18686
commit ce005a58df
+32 -9
View File
@@ -9,16 +9,28 @@ Personal NixOS configuration for **miku-homelab**, built with Flakes and Home Ma
- KDE Plasma 6
- Secure Boot with Lanzaboote
- Steam and gaming configuration
- PipeWire audio stack
- PipeWire audio stack with per-app routing (Discord, mic, music, VBAN send, misc)
- Docker / container services
- Flatpak support
- Deskflow (keyboard/mouse sharing across machines)
- nix-ld for running unpatched dynamic binaries
- VS Code Server
- Agent tooling configuration (AGENTS.md / agents.nix)
- Declarative user environment
## Repository Layout
```text
.
├── AGENTS.md
├── flake.nix
├── flake.lock
├── README.md
├── TODO.md
├── .gitignore
├── .vscode/
│ └── mcp.json
├── hosts/
│ └── miku-homelab/
│ ├── default.nix
@@ -29,11 +41,14 @@ Personal NixOS configuration for **miku-homelab**, built with Flakes and Home Ma
│ │ ├── firefox.nix
│ │ └── plasma.nix
│ │
│ ├── nixos/
│ │
│ ├── security/
│ │ └── secureboot.nix
│ │
│ ├── services/
│ │ ├── containers.nix
│ │ ├── flatpak.nix
│ │ ├── maintenance.nix
│ │ └── vscode-server.nix
│ │
@@ -43,6 +58,7 @@ Personal NixOS configuration for **miku-homelab**, built with Flakes and Home Ma
│ ├── gaming.nix
│ ├── graphics.nix
│ ├── networking.nix
│ ├── nix-ld.nix
│ ├── packages.nix
│ ├── shells.nix
│ └── users.nix
@@ -50,14 +66,22 @@ Personal NixOS configuration for **miku-homelab**, built with Flakes and Home Ma
└── home/
└── emmatherock/
├── home.nix
├── packages.nix
├── agents.nix
├── audio.nix
├── deskflow.nix
├── desktop-apps.nix
├── gaming.nix
├── git.nix
├── media.nix
├── packages.nix
├── shell.nix
├── vscode.nix
── obs.nix
├── gaming.nix
├── media.nix
└── desktop-apps.nix
── pipewire/
├── 10-discord.conf
├── 10-mic.conf
├── 10-misc.conf
├── 10-music.conf
└── 10-vban-send.conf
```
## Applying Configuration
@@ -90,7 +114,7 @@ User configuration is located in:
home/emmatherock/
```
Desktop applications, development tools, gaming utilities, shell configuration, and editor configuration are managed there.
Desktop applications, development tools, gaming utilities, shell configuration, editor configuration, per-app PipeWire routing, and Deskflow are managed there.
## Design Principles
@@ -100,7 +124,6 @@ Desktop applications, development tools, gaming utilities, shell configuration,
- Drivers, hardware, networking, audio services, and boot configuration remain managed by NixOS.
- Each module should have a single responsibility.
- Changes should be incremental and easy to review.
## Rebuilding
After modifying the configuration: