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

/* ── 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:

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