diff --git a/README.md b/README.md
new file mode 100644
index 0000000..1fc4ed6
--- /dev/null
+++ b/README.md
@@ -0,0 +1,25 @@
+# Brutalist
+
+A loud, honest theme built on chunky black borders, candy-bright accents, and hard offset shadows that snap on hover. Oversized grotesque headings sit on a strict grid, with structure left exposed on purpose. It has the sticker energy of a creative studio that wants its work to shout. The look is playful, and it stays legible.
+
+## Good for
+
+We built Brutalist for studios and makers who want a confident, unmissable site. Treat these as starting points, not limits. If the mood fits your brand, use it:
+
+- Design and creative studios
+- Indie software and product launches
+- Architecture and interior firms
+- Art galleries and zine shops
+- Portfolios that want to stand out
+
+## What you get
+
+- Four color presets, each with a tuned light mode and a tuned dark mode: Concrete & Cadmium, Hazard, Riso, and Acid.
+- Space Grotesk and Archivo Black for headings, Inter for body, and IBM Plex Mono for details, all bundled. Fonts stay admin-controlled, so you can swap them from the typography settings.
+- Four persona blocks: a project ledger for indexing work, a sticker wall of pinned badges, a changelog for release notes, and a spec sheet for hard facts.
+- 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.