From d910100c457a43d4429a4b8d4d7b006e294b4088 Mon Sep 17 00:00:00 2001
From: "Chatsworth St. Clair" <chatsworth@beacon.co.uk>
Date: Sat, 7 Mar 2026 16:24:41 +0000
Subject: [PATCH] docs: enhance README with project structure and development
 setup

---
 README.md | 31 +++++++++++++++++++++++++++++--
 1 file changed, 29 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index df4ffd2f..3bbb1f67 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,31 @@
 # Game Master Monorepo
 
-## Under Construction
-It became clear that the game master project would benefit from a monorepo setup to share API logic between the dedicated handler and the Remix client. Currently under construction.
+A Dungeons & Dragons campaign management tool with a Phoenix/Elixir backend and React/TanStack frontend.
+
+## Project Structure
+
+This monorepo uses `pnpm` workspaces and Turbo for build orchestration:
+
+- **packages/** - Shared packages and utilities
+- **apps/** - Application services (API handler, Remix client)
+
+The separation enables code sharing between the API and frontend while maintaining clean package boundaries.
+
+## Development
+
+Install dependencies:
+```bash
+pnpm install
+```
+
+Run development servers:
+```bash
+pnpm dev
+```
+
+Run tests:
+```bash
+pnpm test
+```
+
+See individual package READMEs for more detailed setup.