diff --git a/README.md b/README.md
new file mode 100644
index 0000000..f9a9f2c
--- /dev/null
+++ b/README.md
@@ -0,0 +1,24 @@
+# Noir
+
+A detective's dossier laid out on the desk. Case-file cards, typewriter type, and black redaction bars set the tone, with a faint film grain over the whole surface. By day it reads like a high-key gallery wall. At night it drops to darkroom black. The mood is investigative and a little tense, and the type stays legible throughout.
+
+## Good for
+
+We built Noir for storytelling with an edge. Treat these as starting points, not limits. If the mood fits your brand, use it:
+
+- True-crime podcasts and newsletters
+- Investigative journalism and long-form reporting
+- Mystery authors and book launches
+- Escape rooms and immersive events
+
+## What you get
+
+- Five color presets, each with a tuned light mode and a tuned dark mode: Cold Case, Evidence Red, Safelight, Interrogation, and Redaction.
+- Source Serif 4 for reading and IBM Plex Mono for labels and stamps, both bundled. Fonts stay admin-controlled, so you can swap them from the typography settings.
+- Four persona blocks: a case dossier, a stamped case-file card, an evidence board with pinned notes, and a redacted quote with blacked-out lines.
+- A demo site that installs when you activate the theme: a home page, an about page, a short blog, and a contact page whose form emails your admins.
+- Every core block restyled to match, plus a themed login screen and a themed 404 page.
+
+## Install
+
+Install from the BlockNinja registry, then pick a preset and assign your fonts in the admin. Activate the demo content if you want a fully built starting point.