Mapping-and-Inventory/UI_Visual_Standards.md

# UI Visual Standards — Corner Store Parallax & Floating Composition

*Mapping-and-Inventory v22.2171 | RESONANCE_HARDENING*

This document records the visual design language of the Corner Store Wix
storefront and codifies it as a reusable CSS/layout template for all
fleet-facing Truth Teller portals and Gradio faceplates.

---

## 1. Design Principles

| Principle | Value |
|---|---|
| **Primary sensation** | Floating — content layers appear suspended in deep space |
| **Target refresh** | 144 Hz smooth scroll and parallax |
| **Colour palette** | Deep black `#000000`, electric cyan `#00FFFF`, gold accent `#FFD700` |
| **Typography** | Monospace stack: `'Courier New', Courier, monospace` |
| **Depth layers** | 3 discrete Z-index bands (background, mid, foreground) |

---

## 2. Parallax Depth Settings

The parallax effect is achieved with three stacked layers scrolling at
different rates, producing the "floating" spatial sensation.

| Layer | Z-index | Scroll speed (relative) | CSS class |
|---|---|---|---|
| Background (stars / void) | `0` | `0.2×` | `.layer-bg` |
| Mid-ground (content cards) | `1` | `0.6×` | `.layer-mid` |
| Foreground (nav / HUD) | `2` | `1.0×` | `.layer-fg` |

### CSS Template

```css

/* ── Corner Store Parallax Foundation ─────────────────────────────────── */



:root {

  --color-void:   #000000;

  --color-cyan:   #00FFFF;

  --color-gold:   #FFD700;

  --color-panel:  rgba(0, 255, 255, 0.05);

  --color-border: rgba(0, 255, 255, 0.2);

  --font-mono:    'Courier New', Courier, monospace;

  --transition:   0.3s ease;

  --border-radius: 8px;

}



/* Viewport reset */

html, body {

  margin: 0;

  padding: 0;

  background: var(--color-void);

  color: var(--color-cyan);

  font-family: var(--font-mono);

  overflow-x: hidden;

}



/* Parallax container */

.parallax-root {

  position: relative;

  height: 100vh;

  overflow: hidden;

  perspective: 1px;

}



/* Layer — background (stars / ambient) */

.layer-bg {

  position: absolute;

  inset: 0;

  transform: translateZ(-0.8px) scale(1.8);

  background-image:

    radial-gradient(circle, rgba(0,255,255,0.08) 1px, transparent 1px);

  background-size: 60px 60px;

  will-change: transform;

}



/* Layer — mid-ground (product cards / content) */

.layer-mid {

  position: absolute;

  inset: 0;

  transform: translateZ(-0.4px) scale(1.4);

  will-change: transform;

}



/* Layer — foreground (HUD / navigation) */

.layer-fg {

  position: relative;

  z-index: 2;

  will-change: transform;

}



/* Floating card — used for product panels and Truth Teller portals */

.floating-card {

  background: var(--color-panel);

  border: 1px solid var(--color-border);

  border-radius: var(--border-radius);

  padding: 1.5rem;

  box-shadow:

    0 0 20px rgba(0, 255, 255, 0.1),

    0 0 60px rgba(0, 255, 255, 0.04);

  transition: box-shadow var(--transition), transform var(--transition);

  backdrop-filter: blur(4px);

}



.floating-card:hover {

  transform: translateY(-4px);

  box-shadow:

    0 0 40px rgba(0, 255, 255, 0.25),

    0 0 80px rgba(0, 255, 255, 0.10);

}



/* Gold accent rule — used below section headings */

.accent-rule {

  border: none;

  border-top: 1px solid var(--color-gold);

  opacity: 0.4;

  margin: 0.5rem 0 1.5rem;

}



/* CTA button */

.btn-sovereign {

  display: inline-block;

  padding: 0.6rem 1.4rem;

  background: transparent;

  color: var(--color-cyan);

  border: 1px solid var(--color-cyan);

  border-radius: var(--border-radius);

  font-family: var(--font-mono);

  letter-spacing: 0.1em;

  cursor: pointer;

  transition: background var(--transition), color var(--transition);

}



.btn-sovereign:hover {

  background: var(--color-cyan);

  color: var(--color-void);

}

```

---

## 3. Product Page Logic (Fridge / Storage Units)

Each product panel maps to the `.floating-card` component above.

```

┌────────────────────────────────────────────────────────────────┐

│  .floating-card                                                │

│  ┌──────────────────┐  ┌─────────────────────────────────────┐ │

│  │  Product image   │  │  Product title (cyan, 1.1rem)       │ │

│  │  (layer-mid bg)  │  │  Short description (0.85rem)        │ │

│  └──────────────────┘  │  Price (gold accent)                │ │

│                        │  [  Add to Cart  ]  .btn-sovereign  │ │

│                        └─────────────────────────────────────┘ │

└────────────────────────────────────────────────────────────────┘

```

- **Grid layout**: `display: grid; grid-template-columns: 1fr 2fr; gap: 1.5rem;`
- **Image container**: `border-radius: 4px; overflow: hidden; border: 1px solid var(--color-border);`
- **Price**: `color: var(--color-gold); font-size: 1.2rem;`

---

## 4. Truth Teller Portal Adaptation

When deploying the visual language to a Gradio faceplate or other node
portal, apply these inline overrides to the Gradio `css=` parameter:

```python

TRUTH_TELLER_CSS = """

body, .gradio-container {

    background: #000000 !important;

    color: #00FFFF !important;

    font-family: 'Courier New', Courier, monospace !important;

}

.gr-button {

    background: transparent !important;

    border: 1px solid #00FFFF !important;

    color: #00FFFF !important;

    border-radius: 8px !important;

}

.gr-button:hover {

    background: #00FFFF !important;

    color: #000000 !important;

}

.gr-box, .gr-panel {

    background: rgba(0,255,255,0.05) !important;

    border: 1px solid rgba(0,255,255,0.2) !important;

    border-radius: 8px !important;

    box-shadow: 0 0 20px rgba(0,255,255,0.1) !important;

}

"""

```

---

## 5. Texture-by-Texture Build History

| Step | Element | Setting |
|---|---|---|
| 1 | Viewport | `background: #000000`, `overflow: hidden` |
| 2 | Stars layer | Radial-gradient dot pattern, 60 px grid, `translateZ(-0.8px)` |
| 3 | Mid layer | Content cards, `translateZ(-0.4px)` |
| 4 | Foreground | HUD/nav, `translateZ(0)` |
| 5 | Cards | `backdrop-filter: blur(4px)`, cyan glow shadow |
| 6 | Hover effect | `-4px` lift, increased glow |
| 7 | Typography | Monospace, cyan primary, gold accent for prices |
| 8 | Buttons | Transparent background, cyan border, invert on hover |

---

## 6. Node Deployment Checklist

Before deploying these standards to a new fleet node:

- [ ] Import `TRUTH_TELLER_CSS` string into the Gradio `gr.Blocks(css=…)` call
- [ ] Ensure `.floating-card` is applied to all panel-type components
- [ ] Verify 144 Hz: `scroll-behavior: smooth` on `html`, no blocking JS on scroll
- [ ] Test parallax on mobile: replace `translateZ` with `background-attachment: fixed` fallback
- [ ] Confirm colour contrast: cyan `#00FFFF` on black `#000000` passes WCAG AA

---

*Last updated: 2026-04-16 | Spec: v22.2171 RESONANCE_HARDENING*