From b2d1df72f9f03e6158322af40ffad32596189005 Mon Sep 17 00:00:00 2001
From: huntedbytheirs <huntedbyth3irs@gmail.com>
Date: Sat, 8 Aug 2026 17:10:04 -0400
Subject: [PATCH] chore: scaffold dub project with TOML dep

---
 .gitignore         |  4 ++++
 README.md          | 23 ++++++++++++++++++++++-
 dub.json           | 12 ++++++++++++
 src/main.d         |  7 +++++++
 src/tofu/package.d |  4 ++++
 5 files changed, 49 insertions(+), 1 deletion(-)
 create mode 100644 dub.json
 create mode 100644 src/main.d
 create mode 100644 src/tofu/package.d

diff --git a/.gitignore b/.gitignore
index 2758450..126f80d 100644
--- a/.gitignore
+++ b/.gitignore
@@ -17,10 +17,14 @@
 
 # DUB
 .dub
+.dub/
 docs.json
 __dummy.html
 docs/
 
+# tofu binary
+/tofu
+
 # Code coverage
 *.lst
 
diff --git a/README.md b/README.md
index 821f6db..f45d745 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,24 @@
 # tofu
 
-A package manager for the ZereneOS Unofficial User Repository
\ No newline at end of file
+A package manager for the ZereneOS Unofficial User Repository
+
+## What it is
+
+A Dlang wrapper around zeta-toolchain and ZETA for the ZUUR recipe repository, in the style of yay/paru for the ZereneOS ecosystem.
+
+## Requirements
+
+- dub
+- a D compiler (dmd or ldc2)
+- lua
+- curl
+- zeta-toolchain
+- Zeta
+
+## Build
+
+```
+dub build
+```
+
+Produces the `./tofu` binary.
diff --git a/dub.json b/dub.json
new file mode 100644
index 0000000..68e55b6
--- /dev/null
+++ b/dub.json
@@ -0,0 +1,12 @@
+{
+	"name": "tofu",
+	"description": "A package manager for the ZereneOS Unofficial User Repository",
+	"authors": ["huntedbytheirs"],
+	"license": "BSD-3-Clause",
+	"targetType": "executable",
+	"targetName": "tofu",
+	"dependencies": {
+		"toml": "~>1.0.0"
+	},
+	"buildOptions": ["warningsAsErrors"]
+}
diff --git a/src/main.d b/src/main.d
new file mode 100644
index 0000000..d1d468b
--- /dev/null
+++ b/src/main.d
@@ -0,0 +1,7 @@
+import std.stdio;
+
+int main()
+{
+    writeln("tofu: ZUUR package manager");
+    return 0;
+}
diff --git a/src/tofu/package.d b/src/tofu/package.d
new file mode 100644
index 0000000..ca27cb3
--- /dev/null
+++ b/src/tofu/package.d
@@ -0,0 +1,4 @@
+/// tofu — a package manager for the ZereneOS Unofficial User Repository.
+///
+/// Future modules (config, log, types, ...) live under this package.
+module tofu;