diff --git a/README.md b/README.md
new file mode 100644
index 0000000..19788dd
--- /dev/null
+++ b/README.md
@@ -0,0 +1,25 @@
+# LCARS
+
+A retro-futurist theme built as a full library-computer interface. Angular pill rails, numeric readouts, and stardate furniture frame every surface, so the chrome itself becomes the layout. It reads like the console of a 24th-century starship. Amber and lilac panels sit over true black in dark mode.
+
+## Good for
+
+We built LCARS for sci-fi media and fandom. Treat these as starting points, not limits. If the mood fits your brand, use it:
+
+- Sci-fi podcasts and audio shows
+- Fan sites and episode archives
+- Tech and gaming communities
+- Convention and event pages
+
+## What you get
+
+- Five color presets, each with a tuned light mode and a tuned dark mode: Ops Amber, Red Alert, Blue Console, Nebula, and Medbay Green.
+- Two bundled fonts, ready to assign: Antonio for condensed panel headings and Share Tech Mono for readouts and labels. Fonts stay admin-controlled, so you can swap them from the typography settings.
+- A GO BIG hero with an animated canvas panel-sweep. It honors reduced-motion settings and draws a single static frame when scripts are off.
+- Four persona blocks: an episode console, a crew roster, a stardate log, and a transmission-status readout.
+- A demo site that installs when you activate the theme: a home page, an about page, an episode feed with three articles, 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.