From 696060e4b1c8e3bf61162a586484648cdc72ac0c Mon Sep 17 00:00:00 2001
From: Manu <1533514+ubermanu@users.noreply.github.com>
Date: Sun, 7 Jun 2026 08:35:57 +0200
Subject: [PATCH] docs: add README with logo and source attribution

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

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..3719a85
--- /dev/null
+++ b/README.md
@@ -0,0 +1,31 @@
+<p align="center">
+  <img src="icon.svg" alt="Shadowdark Logo" width="120" />
+</p>
+
+<h1 align="center">Shadowdark — Codex</h1>
+
+<p align="center">
+  Game data for <strong>Shadowdark RPG</strong>, packaged as a <a href="https://github.com/tabletopmancer/tabletopmancer">Tabletopmancer</a> codex.
+</p>
+
+---
+
+> Shadowdark RPG is fast, familiar, intuitive, and deadly. It's built for sword-and-sorcery adventures where fell monsters slither in darkness and ancient gems glint upon forgotten thrones, waiting to be discovered. In Shadowdark RPG, real time comes into play.
+
+## Contents
+
+| Category | Path |
+|----------|------|
+| Ancestries | `data/ancestry/` |
+| Armor | `data/armor/` |
+| Classes | `data/class/` |
+| Spells | `data/spell/` |
+| Weapons | `data/weapon/` |
+
+## Source
+
+Data sourced from the **Shadowdark RPG: Quickstart Set**.
+
+> Shadowdark RPG © 2023 The Arcane Library, LLC.
+
+This codex is an unofficial fan project and is not affiliated with or endorsed by The Arcane Library.