diff --git a/README.md b/README.md
new file mode 100644
index 0000000..08d6270
--- /dev/null
+++ b/README.md
@@ -0,0 +1,25 @@
+# Cyberpunk
+
+A high-voltage theme built on neon glow over near-black. Magenta, cyan, and lime accents cut across scanlines, glitch splits, and HUD brackets, so a page reads like the interface of a late-night game studio. The hero carries an animated canvas that rains code down the screen. It looks loud, and the type stays legible while it does.
+
+## Good for
+
+We built Cyberpunk for teams that want a screen to feel switched on. Treat these as starting points, not limits. If the mood fits your brand, use it:
+
+- Indie game studios and dev collectives
+- Developer tools and API products
+- Crypto, fintech, and Web3 launches
+- Hackathons and tech event pages
+
+## What you get
+
+- Five color presets, each with a tuned light mode and a tuned dark mode: Neon Noir, Acid Rain, Toxic Bloom, Hotline, and Ghost Protocol.
+- Orbitron for display headings, Share Tech Mono for code and labels, and Inter for body text. All three ship bundled. Fonts stay admin-controlled, so you can swap them from the typography settings.
+- An animated canvas hero that rains code behind the headline. It waits until it scrolls into view, honors reduced-motion, and falls back to a static neon gradient when scripting is off.
+- Four persona blocks: a glitch hero, a neon code panel, a team roster grid, and a patch-notes feed.
+- 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. It comes seeded as a studio called Neon Forge.
+- 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.