From 15a9c5642821d117edd5a60a6511188e63e400d2 Mon Sep 17 00:00:00 2001
From: StanisLove <me@tungulov.space>
Date: Tue, 14 Jul 2026 13:57:08 +0300
Subject: [PATCH] Add design and product documentation

---
 DESIGN.md  | 13 +++++++++++++
 PRODUCT.md | 21 +++++++++++++++++++++
 2 files changed, 34 insertions(+)
 create mode 100644 DESIGN.md
 create mode 100644 PRODUCT.md

diff --git a/DESIGN.md b/DESIGN.md
new file mode 100644
index 0000000..784fb3a
--- /dev/null
+++ b/DESIGN.md
@@ -0,0 +1,13 @@
+# Design — Monochrome Supply
+
+## Direction
+
+Product-first fashion editorial: monochrome palette, strict grid, large photography, restrained typography, and minimal commerce chrome.
+
+## System
+
+- Reuse semantic tokens; product media owns most visual emphasis.
+- Use sharp alignment and controlled whitespace instead of nested cards.
+- Controls must expose selected, unavailable, hover, focus, and loading states.
+- Motion is subtle and material-aware; disable nonessential transitions for reduced motion.
+- Mobile prioritizes imagery, variant selection, price, delivery, and purchase action.
diff --git a/PRODUCT.md b/PRODUCT.md
new file mode 100644
index 0000000..a0a96e7
--- /dev/null
+++ b/PRODUCT.md
@@ -0,0 +1,21 @@
+# Product — Monochrome Supply
+
+Status: approved baseline.
+
+## Audience and job
+
+Style-conscious customers need to discover a focused collection, inspect garment detail and fit, choose a valid variant, and understand delivery and returns before purchase.
+
+## Primary journeys
+
+1. Browse editorial collection stories and product categories.
+2. Evaluate product imagery, material, fit, size, color, price, and availability.
+3. Add a valid variant to cart and review shipping and return expectations.
+
+## Non-goals
+
+- No fake scarcity, unavailable checkout integrations, or decorative controls without state.
+
+## Success criteria
+
+Products dominate the interface, variant state is unambiguous, and mobile shopping remains fast and readable.