Add design folder and README

design/spotlight.md

@@ -0,0 +1,49 @@
+# Spotlight Feature
+
+**Purpose**: Global search overlay that lets users find any Kubernetes object, existing krates, namespaces, or collection categories, and open specific views.
+
+**Trigger**:
+- Click on empty canvas.
+- Type any printable key when no input is focused (pre‑seeds query).
+- `/` key opens an empty spotlight.
+
+**Layout**:
+- Full‑screen dark backdrop `rgba(7,9,13,.55)` with `backdrop‑filter: blur(2px)`.
+- Centered panel (max 660 px, 93 % viewport width) with background `rgba(16,20,28,.97)`, border `1px solid rgba(140,165,200,.26)`, border‑radius `14px`.
+- Input row (≈ 52 px high) containing:
+  - Search glyph `⌕` (accent color).
+  - Optional type‑filter pill.
+  - Text input (font‑size 18 px, IBM Plex Sans).
+  - Optional Tab‑ghost hint.
+- Horizontal **type chips** row (scrollable on narrow screens) for all object kinds (`pods`, `svc`, `deploy`, `secret`, `cm`, `sts`, …).
+- Results list (max‑height 48 vh, overflow‑auto) – each row shows:
+  - Shape glyph (type‑specific).
+  - Name.
+  - Subtext `type · ns/namespace`.
+  - CRD badge if applicable.
+  - Type badge.
+- **View chips** appear on the selected result only: `⌥L logs · ⌥S shell · ⌥D describe · ⌥Y yaml`. Views are limited to object capabilities (e.g., logs & shell only for pods, deployments, daemonsets, statefulsets).
+- Footer hint line.
+
+**Fuzzy Search Algorithm** (used in the prototype):
+- Score = character‑match score × 10 + type boost.
+- Type boost values: crd 60, deployment 50, statefulset 48, service 46, daemonset 44, ingress 42, secret 24, configmap 22, pvc 18, pod 16.
+- Character match: sequential chars, +3 for consecutive, +5 for word‑boundary start.
+- Top 8 results displayed.
+
+**Tab Quick‑Filter**:
+- Typing a type alias (`pod`, `svc`, `deploy`, etc.) shows a ghost hint `⇥ Pods`.
+- Press **Tab** to lock filter as a pill; Backspace removes it.
+- Tab also cycles through recently used type filters (most‑recent first).
+
+**Keyboard Shortcuts** (Alt/Option required):
+- `Alt+L` = open **Logs** view for selected result.
+- `Alt+S` = open **Shell** view.
+- `Alt+D` = open **Describe** view.
+- `Alt+Y` = open **YAML** view.
+- `Enter` = open default view (logs for pods, describe for workloads, yaml for config resources) and close spotlight.
+- `Esc` = close spotlight; if a krate was summoned it is placed on canvas.
+- `↑/↓` = navigate results.
+- `Tab` = apply/cycle type filter.
+
+**Auto‑Close**: after 500 ms of keyboard idle the spotlight auto‑closes and the camera flies to the newly created krate.