From 0009cc47e4075780c7db98c7ce753ddef398317c Mon Sep 17 00:00:00 2001
From: araharah-executor <executor@araharah.local>
Date: Thu, 22 Oct 2026 07:37:35 +0800
Subject: [PATCH] docs(01-design-tokens-rams-foundation-01): supersede root
 DESIGN.md specifics; point README at token package
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- DESIGN.md: 3-line SUPERSEDED-FOR-SPECIFICS banner at very top (D-05) — token package is the single source of truth; conflicting typography claims (Helvetica/Inter, 5-color palette) explicitly superseded; Rams philosophy prose kept
- README.md: Design system section — theme/ token package, consume via theme/src/tokens.css import or npm run build; no numeric values restated (D-07)
---
 DESIGN.md | 4 ++++
 README.md | 7 +++++++
 2 files changed, 11 insertions(+)
 create mode 100644 README.md

diff --git a/DESIGN.md b/DESIGN.md
index 12249aa..5590d46 100644
--- a/DESIGN.md
+++ b/DESIGN.md
@@ -1,3 +1,7 @@
+> ⚠ SUPERSEDED FOR SPECIFICS — the centralized token set is the single source of truth for all numeric values (colors, sizes, spacing).
+> This document is kept for Rams design philosophy only. Consult the token package (see README.md) for specific value definitions.
+> Conflicting typography claims in this document (Helvetica/Inter, 5-color palette) are superseded by the token package.
+
 DESIGN.md
 
 Design Philosophy
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..0fa7603
--- /dev/null
+++ b/README.md
@@ -0,0 +1,7 @@
+# araharah
+
+A privacy-respecting, Telegram-first GPS navigator — Rams-inspired instrument-panel design, OpenStreetMap-based routing, KL metro first.
+
+## Design system
+
+The Telemetry Rams design system lives in `theme/` as a Tailwind v4 CSS-first token package — the single source of truth for every color, spacing, typography, and radius value in the project. Consume the tokens by importing `theme/src/tokens.css` (plain CSS custom properties, usable by any stylesheet or the MapLibre basemap) or the compiled stylesheet produced by `npm run build`. The token vocabulary mirrors the mockup screens verbatim, so markup derived from them maps one to one. Rams philosophy lives on in `DESIGN.md`, which is superseded for specifics — values are never restated outside the token package.