|
| 1 | +--- |
| 2 | +version: "alpha" |
| 3 | +name: "Nur Colab Map" |
| 4 | +description: "Mobile-first RTL map UI with dark glass overlays for planning workflows." |
| 5 | +colors: |
| 6 | + surface-canvas: "#0D1016" |
| 7 | + surface-glass: "#141414" |
| 8 | + surface-panel: "#18181C" |
| 9 | + border-soft: "#FFFFFF29" |
| 10 | + text-primary: "#FFFFFFF2" |
| 11 | + text-secondary: "#FFFFFFB3" |
| 12 | + accent-pink: "#FF69B4" |
| 13 | + accent-green-a: "#39B96B" |
| 14 | + accent-green-b: "#60D58E" |
| 15 | + danger-soft: "#DC3232" |
| 16 | +typography: |
| 17 | + body-sm: |
| 18 | + fontFamily: Inter |
| 19 | + fontSize: 0.75rem |
| 20 | + fontWeight: 500 |
| 21 | + lineHeight: 1.3 |
| 22 | + body-md: |
| 23 | + fontFamily: Inter |
| 24 | + fontSize: 0.875rem |
| 25 | + fontWeight: 500 |
| 26 | + lineHeight: 1.35 |
| 27 | + title-sm: |
| 28 | + fontFamily: Inter |
| 29 | + fontSize: 1rem |
| 30 | + fontWeight: 700 |
| 31 | + lineHeight: 1.35 |
| 32 | +rounded: |
| 33 | + xs: 8px |
| 34 | + sm: 10px |
| 35 | + md: 12px |
| 36 | + lg: 14px |
| 37 | + pill: 999px |
| 38 | +spacing: |
| 39 | + xs: 4px |
| 40 | + sm: 6px |
| 41 | + md: 8px |
| 42 | + lg: 10px |
| 43 | + xl: 12px |
| 44 | +components: |
| 45 | + map-glass-bar: |
| 46 | + backgroundColor: "{colors.surface-glass}" |
| 47 | + textColor: "{colors.text-primary}" |
| 48 | + rounded: "{rounded.sm}" |
| 49 | + padding: "{spacing.md}" |
| 50 | + button-primary: |
| 51 | + backgroundColor: "{colors.accent-green-a}" |
| 52 | + textColor: "#052210" |
| 53 | + rounded: "{rounded.xs}" |
| 54 | + padding: "{spacing.md}" |
| 55 | + button-secondary: |
| 56 | + backgroundColor: "{colors.surface-glass}" |
| 57 | + textColor: "{colors.text-primary}" |
| 58 | + rounded: "{rounded.xs}" |
| 59 | + padding: "{spacing.md}" |
| 60 | + chip: |
| 61 | + backgroundColor: "{colors.surface-glass}" |
| 62 | + textColor: "{colors.text-primary}" |
| 63 | + rounded: "{rounded.pill}" |
| 64 | + padding: "{spacing.sm}" |
| 65 | +--- |
| 66 | + |
| 67 | +## Overview |
| 68 | + |
| 69 | +`nur-colab-map` uses a map-first, dark-glass interface where overlays support editing and planning without hiding geographic context. |
| 70 | +Hebrew + RTL is the default product language and layout direction. |
| 71 | + |
| 72 | +## Colors |
| 73 | + |
| 74 | +- **Canvas:** deep dark surfaces (`surface-canvas`) keep satellite maps legible under overlays. |
| 75 | +- **Glass overlays:** translucent dark bars/panels with low-opacity white borders. |
| 76 | +- **Text:** high-contrast white with softer secondary copy. |
| 77 | +- **Accents:** pink for project/heritage highlights, green for primary positive actions. |
| 78 | +- **Danger:** soft red tint for destructive actions (`נקה הכל`, delete/clear patterns). |
| 79 | + |
| 80 | +## Typography |
| 81 | + |
| 82 | +- Base UI text is compact (`body-sm`, `body-md`) to preserve map space on mobile. |
| 83 | +- Titles and section headers use `title-sm`. |
| 84 | +- Preferred stack in implementation/mocks: `Inter, "Noto Sans Hebrew", Arial, sans-serif`. |
| 85 | + |
| 86 | +## Layout |
| 87 | + |
| 88 | +- **Mobile-first safe-area model:** overlays respect `--map-safe-*` and `env(safe-area-inset-*)`. |
| 89 | +- **Map insets:** map viewport is padded vertically by `--map-top-chrome` and `--map-bottom-chrome`. |
| 90 | +- **Chrome zones:** |
| 91 | + - **Top zone (global):** submission/project/account controls. |
| 92 | + - **Bottom zone (contextual):** project-specific editing toolbar (pink/memorial). |
| 93 | +- New persistent controls should dock to these existing zones, not create disconnected floating islands. |
| 94 | + |
| 95 | +## Elevation & Depth |
| 96 | + |
| 97 | +- Use subtle blur (`12-14px`) and soft borders for bars/popovers. |
| 98 | +- Stronger panel opacity for sheets/modals than for persistent bars. |
| 99 | +- Keep shadows restrained; avoid heavy glow except for active/emphasis states. |
| 100 | + |
| 101 | +## Shapes |
| 102 | + |
| 103 | +- Small controls: `rounded.xs` (8px) |
| 104 | +- Toolbar/panel shells: `rounded.sm` / `rounded.md` (10-12px) |
| 105 | +- Modal/sheet major surfaces: `rounded.lg` (14px+) |
| 106 | +- Counts/chips/toggles: `rounded.pill` |
| 107 | + |
| 108 | +## Components |
| 109 | + |
| 110 | +### Existing Shell Contract |
| 111 | + |
| 112 | +- **Top control cluster** remains the canonical home for global map context. |
| 113 | +- **Bottom toolbar** remains the canonical home for edit-mode actions. |
| 114 | +- Layer/basemap/legend controls must integrate around this shell. |
| 115 | + |
| 116 | +### Layer Control Pattern (V1 target) |
| 117 | + |
| 118 | +- One compact trigger (`שכבות (N)`) near existing global or bottom-adjacent controls. |
| 119 | +- Bottom sheet for full layer operations: |
| 120 | + - `הצג הכל` |
| 121 | + - `הסתר הכל` |
| 122 | + - pack toggles |
| 123 | + - per-layer toggles |
| 124 | + - basemap segmented row (`לוויין | OSM`) |
| 125 | +- Show pack state as `off | partial | on` with counts (`2/5`). |
| 126 | + |
| 127 | +### Legend Pattern |
| 128 | + |
| 129 | +- Legend is controlled explicitly via `מקרא`. |
| 130 | +- Legend display is grouped by **active packs only**. |
| 131 | +- On mobile, legend should be a compact tray/card or sheet tab, not a permanent large panel. |
| 132 | + |
| 133 | +### Basemap Pattern |
| 134 | + |
| 135 | +- V1 scope: binary switch only (`לוויין` / `OSM`). |
| 136 | +- Basemap changes must not alter layer visibility state. |
| 137 | + |
| 138 | +## Do's and Don'ts |
| 139 | + |
| 140 | +### Do |
| 141 | + |
| 142 | +- Design in RTL/Hebrew from the start. |
| 143 | +- Keep controls dense but tappable. |
| 144 | +- Minimize vertical spacing between new and existing controls when screen pressure is high. |
| 145 | +- Keep map visibility primary. |
| 146 | +- Reflect real shell constraints in mockups (top + bottom existing bars). |
| 147 | + |
| 148 | +### Don't |
| 149 | + |
| 150 | +- Do not introduce bright/light UI islands that clash with current dark-glass style. |
| 151 | +- Do not hide key controls behind deep nested interactions. |
| 152 | +- Do not duplicate control responsibilities across multiple permanent panels. |
| 153 | +- Do not let legend dominate the viewport on mobile. |
| 154 | +- Do not ship mockups that ignore existing toolbar placement or safe-area behavior. |
| 155 | + |
| 156 | +## Mockup Authoring Rules |
| 157 | + |
| 158 | +For files under `docs/superpowers/mockups/*.html`: |
| 159 | + |
| 160 | +- Use standalone HTML (inline CSS/JS, no build step required). |
| 161 | +- Set `<html lang="he" dir="rtl">`. |
| 162 | +- Show **current shell + new overlay additions** unless intentionally exploring shell redesign. |
| 163 | +- Include at least two states where relevant (closed/open, legend hidden/shown). |
| 164 | +- Use realistic Hebrew labels and counts from project context. |
| 165 | + |
| 166 | +## Review Checklist |
| 167 | + |
| 168 | +- Does it match current app shell structure? |
| 169 | +- Is RTL/Hebrew correctly applied? |
| 170 | +- Is mobile spacing realistic (especially vertical stack pressure)? |
| 171 | +- Are layer, basemap, and legend responsibilities clear and separate? |
| 172 | +- Can user do all required layer actions (show all/hide all + per-layer)? |
| 173 | +- Is legend control location clear, and legend display location clear? |
0 commit comments