From 1fd5b7ade7375b3a6240a789f3a409e7a27c8e88 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..c02c103
--- /dev/null
+++ b/DESIGN.md
@@ -0,0 +1,13 @@
+# Design — Northyard Residences
+
+## Direction
+
+Premium residential editorial with light stone tones, precise plans, quiet bento composition, and photography-led confidence.
+
+## System
+
+- Reuse semantic tokens and reserve accent color for availability and action.
+- Balance generous editorial space with dense apartment facts.
+- Plans must remain legible and never become decorative thumbnails.
+- Motion supports spatial orientation and gallery continuity; reduced-motion fallback is required.
+- Mobile keeps price, availability, plan, and enquiry action together.
diff --git a/PRODUCT.md b/PRODUCT.md
new file mode 100644
index 0000000..1a205d9
--- /dev/null
+++ b/PRODUCT.md
@@ -0,0 +1,21 @@
+# Product — Northyard Residences
+
+Status: approved baseline.
+
+## Audience and job
+
+Home buyers and advisers need to understand the development, compare available apartments, inspect plans and amenities, estimate financing, and request a qualified consultation.
+
+## Primary journeys
+
+1. Understand location, architecture, amenities, and delivery status.
+2. Filter apartments and inspect plan, area, floor, orientation, price, and availability.
+3. Explore financing and submit a contextual enquiry.
+
+## Non-goals
+
+- No fabricated availability, guaranteed investment returns, or hidden price conditions.
+
+## Success criteria
+
+Apartment comparison is clear, factual claims are sourced, and the enquiry preserves the selected property context.