Add docs

docs/design-system/customization.md

@@ -0,0 +1,41 @@
+# Customization without forking
+
+Цель: дать пользователю возможность менять дизайн **не изменяя библиотеку**.
+
+Есть три уровня кастомизации:
+
+## 1) Switch theme/platform/skin
+
+```tsx
+<UIProvider config={{ theme: "dark", platform: "vk", skin: "ios" }} />
+```
+
+## 2) Runtime overrides (vars)
+
+```tsx
+<UIProvider
+  config={{
+    vars: {
+      "--ui-primary": "#ff2d55",
+      "--btn-radius": "18px",
+      "--input-h-md": "46px",
+    }
+  }}
+/>
+```
+
+## 3) App-level CSS layer
+
+```css
+:root[data-platform="web"]{
+  --ui-primary: #8b5cf6;
+}
+```
+
+## Contract (совместимость)
+
+Мы считаем частью публичного контракта:
+- имена токенов `--ui-*` и `--btn-*`/`--input-*`/…
+- data attributes `data-theme`, `data-platform`, `data-skin`
+
+Изменения этих сущностей должны быть semver‑major.