diff --git a/README.md b/README.md
new file mode 100644
index 0000000..f9b0595
--- /dev/null
+++ b/README.md
@@ -0,0 +1,17 @@
+
+## Styleguide
+
+**vault1984.css** is the single global stylesheet for all vault1984 web surfaces — marketing site (`vault1984-web`) and the app UI (`vault1984`).
+
+- Live: https://vault1984.com/styleguide.html
+- Source: `vault1984-web/vault1984.css`
+
+### Rules (no exceptions)
+1. **One stylesheet.** `vault1984.css` only. No Tailwind, no inline styles, no `<style>` blocks.
+2. **One rule per class.** If you need a variant, add a modifier class (e.g. `.card.gold`), not a new inline style.
+3. **One width.** `--width: 1280px` via `.container`. Never hardcode a max-width anywhere else.
+4. **One padding.** `--pad: 2rem` via `.container`. Never hardcode horizontal padding.
+5. **CSS variables for everything.** Colors, spacing, radius, fonts — all via `var(--*)`.
+
+### To use in vault1984 app
+Copy or symlink `vault1984.css` into `vault1984/web/` and embed it. The token set (colors, fonts, radius) is shared — app UI should feel identical to the marketing site.
diff --git a/vault1984-web b/vault1984-web
index 5301c1d..f47119a 100755
Binary files a/vault1984-web and b/vault1984-web differ