From daa7360b560adfdfe1ffd0686617edff1a040a7d Mon Sep 17 00:00:00 2001
From: Mitsuo Makuda <mitsuo_makuda@sfk.me.uk>
Date: Thu, 13 Nov 2025 13:58:09 +0000
Subject: [PATCH] first commit

---
 README.md | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..e56b6cd
--- /dev/null
+++ b/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.