From a0e45c65d32246cce50fdcf5057abef450171337 Mon Sep 17 00:00:00 2001
From: SFG545 <khyrenjoseph253@Gmail.com>
Date: Sat, 21 Mar 2026 12:48:32 -0500
Subject: [PATCH] Add README.md with initial package definitions and repository
 layout

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

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..3854128
--- /dev/null
+++ b/README.md
@@ -0,0 +1,13 @@
+# Vertex Linux Packages
+
+This repository contains the package definitions, metadata, patches, and related files used to build software for **Vertex Linux**.
+
+It is the main package tree for the Vertex Linux packaging system and is organized by repository/classification.
+
+## Repository Layout
+
+```text
+core/              Essential system packages
+extra/             Additional user-facing and desktop packages
+lib32/             32-bit compatibility packages that cant be built using depot's build-32 easily (eg. libc++)
+depot-index.tsv    Package index / metadata listing
\ No newline at end of file