diff --git a/README.md b/README.md
new file mode 100644
index 0000000..218e224
--- /dev/null
+++ b/README.md
@@ -0,0 +1,24 @@
+# Coffee
+
+A warm, hand-made theme in roasted browns over kraft paper. Hand-drawn doodles, chalk-menu lettering, and stamped badges give it the feel of a neighbourhood café that does everything by hand. It reads friendly and tactile. Nothing about it looks mass-produced.
+
+## Good for
+
+We built Coffee for cafés, roasteries, and slow-craft makers. Treat these as starting points, not limits. If the mood fits your brand, use it:
+
+- Coffee shops and roasteries
+- Bakeries and pastry counters
+- Small-batch food and drink brands
+- Farmers' market and artisan stalls
+
+## What you get
+
+- Five color presets, each with a tuned light mode and a tuned dark mode: Morning Pour, Dark Roast, Kraft Cream, Chalkboard, and Matcha and Oat.
+- Fraunces for headings, Work Sans for body, and Caveat for hand-written touches, all bundled. Fonts stay admin-controlled, so you can swap them from the typography settings.
+- Four persona blocks: a featured pour to spotlight a drink, a roast profile with tasting notes, a stamp-style loyalty card, and a step-by-step brew guide.
+- A demo site that installs when you activate the theme, styled around a roastery: 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.