first commit

README.md

@@ -0,0 +1,32 @@
+# NubNix
+
+> *Declarative environment for legacy Macs, powered by NixOS.*
+
+NubNix is a purpose-built NixOS configuration designed for a single machine (a
+2012 MacBook Pro). However, structured to scale across other systems with
+minimal change. It merges NixOS and Home Manager into a unified, reproducible
+environment while staying lightweight enough to run comfortably on decade-old
+hardware.
+
+## Philosophy
+
+- **Device-aware** tuned specifically for older Intel Macs (Broadcom Wi-Fi,
+  legacy EFI quirks, etc.)
+- **Modular by design** every component can be swapped, reused, or disabled
+  per host
+- **Offline-ready** all required assets are baked into the installation image
+  for fully air-gapped setup
+- **Reproducible** each rebuild yields an identical environment, tracked
+  through Git
+
+## Structure
+
+- `nixos/` — base system configuration (boot, hardware, services)
+- `home/` — user environment and desktop modules
+- `assets/` — wallpapers, themes, offline packages
+- `iso/` — installer definitions for standalone rebuilds
+
+## Status
+
+Functional on the MacBook Pro (A1398, 2012 7,1).
+Refactoring for cross-device deployment in progress.