diff --git a/README.md b/README.md
new file mode 100644
index 0000000..cc0a101
--- /dev/null
+++ b/README.md
@@ -0,0 +1,24 @@
+# Art Deco
+
+A dressed-up theme in champagne gold over jet black, with ivory detailing and geometric fan motifs. Tall engraved headings sit above a slim serif body, so the whole thing carries the mood of a 1920s grand hotel lobby. It reads formal and glamorous, and it stays easy to read.
+
+## Good for
+
+We built Art Deco with hospitality and celebration in mind. Treat these as starting points, not limits. If the mood fits your brand, use it:
+
+- Hotels and fine-dining restaurants
+- Wedding and event venues
+- Jewellers and luxury boutiques
+- Cocktail bars and supper clubs
+
+## What you get
+
+- Four color presets, each with a tuned light mode and a tuned dark mode: Champagne Noir, Ivory & Rose Gold, Velvet Onyx, and Emerald & Gilt.
+- Cinzel headings and Cormorant Garamond body, bundled and ready. Fonts stay admin-controlled, so you can swap them from the typography settings.
+- Four persona blocks: a reservation strip, a menu, a private-dining section, and a chef's signature.
+- A demo site that installs when you activate the theme: a home page, an about page, a short journal, 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 dressed starting point.