# Design Language for martial.quest

## Aesthetics and Tone

martial.quest lives in the collision between a mid-2000s McBling nightclub VIP room and the targeting interface of a mecha cockpit. The aesthetic is **McBling-meets-combat-HUD**: imagine the rhinestone-encrusted flip phone of a 2005 pop star, but every gem is a hexagonal sensor node pulsing with telemetry data. The visual mood is a martial arts dojo reimagined through the lens of a Sidekick III's screensaver -- glossy, bedazzled, unapologetically flashy, but with an underlying framework of tactical precision borrowed from heads-up display systems in fighter jets and anime mech sequences.

The tone is **energetic** -- not the forced enthusiasm of a startup landing page, but the crackling, barely-contained kinetic energy of a fighter entering the ring. Every surface shimmers. Every interaction carries the snap of a well-executed technique. The site should feel like opening a treasure chest that fights back -- opulent, aggressive, alive. Think: the visual love child of Tekken's character select screen and a Juicy Couture storefront, rendered at 120fps with particle effects.

The sepia-nostalgic palette grounds this flashiness in a patina of age, as if these HUD overlays and rhinestone textures were recovered from a time capsule buried in 2006 and displayed on a plasma screen with warm, amber-shifted color reproduction. It is not clean retro pastiche -- it is the real artifact, slightly degraded, beautifully imperfect, glowing with the warmth of CRT phosphors cooling down.

## Layout Motifs and Structure

The layout is built on a **hexagonal honeycomb grid** -- no rectangles, no conventional 12-column bootstrap grids, no centered hero sections. The entire page is a tessellation of hexagonal cells, each one a discrete content module that can expand, contract, pulse, and rotate independently. The honeycomb evokes both the geometric precision of a martial arts training facility's floor tiles and the cell-based targeting grids of a sci-fi tactical display.

**Hexagonal Grid Mechanics:**

- The base grid is constructed using CSS `clip-path: polygon(50% 0%, 100% 25%, 100% 75%, 50% 100%, 0% 75%, 0% 25%)` applied to every content cell. Cells are arranged in a true honeycomb pattern using alternating-row offset, achieved with CSS Grid `grid-template-columns: repeat(auto-fill, minmax(180px, 1fr))` combined with a negative margin offset on every other row of `margin-left: calc(var(--hex-width) / 2)`.

- **Active Cell States:** Hexagons have three visual states: dormant (sepia-tinted, low opacity, static), scanning (subtle clockwise border animation in amber), and engaged (full brightness, pulsing glow, expanded scale). Scrolling through the page causes cells to transition from dormant to scanning to engaged as they enter the viewport center.

- **Combat Topology:** The honeycomb is not flat. Cells at the periphery of the viewport are rendered smaller and more translucent (simulating depth via a radial gradient mask), creating the illusion of a curved tactical display or the inside of a helmet visor. The center cluster of hexagons is always the largest, brightest, and most detailed.

- **Breakpoint Behavior:** On mobile, the honeycomb collapses into a vertical stack of full-width hexagonal cards, each still clip-pathed but arranged in a single column with pointed tops and bottoms interlocking like a zipper. On tablet, the grid reduces to 3 columns. On desktop, 5-7 columns depending on viewport width.

- **Navigation:** There is no traditional nav bar. Instead, a persistent ring of 6 small hexagons floats in the bottom-right corner of the viewport (like a radial menu), each representing a section. Hovering over one triggers a scan-line animation across the entire page grid, highlighting the path from the nav hex to the target section's hex cluster. Clicking teleports the scroll position with a rapid zoom-through-hex animation (scale from 0.1 to 1 on the target section).

## Typography and Palette

**Typography:**

- **Display / Headlines:** "Playfair Display" (Google Fonts) -- weight 900, uppercase, with `letter-spacing: 0.15em` and `text-transform: uppercase`. Playfair's high-contrast thick-thin strokes evoke the ornate, decorative energy of McBling-era branding (think: the masthead of a 2005 fashion magazine). Set at 3rem-6rem for section headers inside hexagonal cells. Each headline character is individually wrapped in a `<span>` and animated with a staggered entrance -- characters arrive one by one with a slight elastic overshoot (`cubic-bezier(0.68, -0.55, 0.27, 1.55)`) and a micro-shake on landing (the shake-error pattern repurposed as a combat-impact effect).

- **Body / Narrative:** "Lato" (Google Fonts) -- weight 300 (Light) for body text, weight 700 for inline emphasis. Lato's humanist warmth prevents the display type from overwhelming the reading experience. Body text is set at 1rem with `line-height: 1.75` and a sepia-shifted color (#5C4A3A) for comfortable reading against warm backgrounds. Paragraphs are constrained to 42ch max-width inside hexagonal cells (the narrow column forces punchy, compact writing).

- **Monospace / HUD Data:** "Share Tech Mono" (Google Fonts) -- weight 400, used exclusively for HUD overlay elements: coordinates, timestamps, stat readouts, targeting reticle labels, and any numerical data. Set in all-caps at 0.7rem-0.85rem with `letter-spacing: 0.3em` to simulate the sparse, precise typography of a cockpit instrument panel. Color: #C4973B (amber-gold) against dark backgrounds, #3A2A1A against light ones.

**Palette:**

The palette is **sepia-nostalgic** -- warm, amber-heavy, with the faded golden quality of a photograph left in sunlight. But punctuated by sharp accent flashes that simulate HUD targeting indicators.

| Role | Color | Hex | Description |
|------|-------|-----|-------------|
| Deep Ground | Charred Parchment | `#1A1208` | Near-black with warm brown undertone; primary dark background |
| Mid Ground | Aged Bronze | `#5C4A3A` | Warm brown for body text and secondary surfaces |
| Surface | Foxed Linen | `#E8D5B5` | The warm off-white of aged paper; primary light background |
| Highlight Surface | Burnished Gold | `#C4973B` | Rich amber-gold for active HUD elements, borders, glows |
| Accent Warm | Dojo Vermillion | `#B34A2A` | Burnt red-orange; used sparingly for alerts, active states |
| Accent Cool | Targeting Teal | `#2A8B7A` | Muted teal-cyan; HUD crosshair color, secondary interactive |
| Glow | Plasma Amber | `#F5C842` | Bright saturated yellow-gold; used only for glow effects and particle trails |
| Whisper | Smoke Umber | `#3A2A1A` | Dark warm brown; used for subtle borders, dividers, shadow tones |

**Gradient Usage:**
- Hero sections use a radial gradient from `#1A1208` (center) to `#3A2A1A` (edges) with a subtle `#C4973B` glow at 30% radius, simulating the warm light source of a dojo lantern behind a tactical display.
- Hexagonal cell borders use a conic gradient sweep: `conic-gradient(from 0deg, #C4973B, #2A8B7A, #C4973B)` animated with `@keyframes` to rotate continuously at 8s per revolution, creating the effect of a scanning beam tracing each hex's perimeter.

## Imagery and Motifs

**Icon-Heavy Visual Language:**

The site communicates primarily through **icons rather than photographs or illustrations**. Every concept, section, and interaction is represented by a custom icon rendered inside a hexagonal frame. Icons are designed in a dual-layer style: a solid sepia-toned silhouette base layer with a thin amber wireframe overlay slightly offset (2-3px), creating a parallax-within-the-icon effect that suggests depth and holographic projection.

**Icon Categories:**
1. **Martial Discipline Icons:** Stylized silhouettes of combat stances, weapon forms (katana, bo staff, nunchaku, fist positions), and training poses. Each icon is contained within a hexagonal border that doubles as a HUD targeting reticle -- tick marks at each vertex, a thin crosshair through the center.
2. **Navigation Icons:** The 6-hex radial nav uses icons derived from martial arts belt ranking symbols, stylized as circuit-board patterns (lines connecting nodes within the hex shape).
3. **Status Icons:** Small hex badges showing readout-style information -- "Ki Level," "Discipline Rank," "Training Phase" -- using Share Tech Mono numerals inside a rotating hex border.
4. **Decorative Scatter Icons:** Tiny (16px-24px) hexagonal icons scattered across negative space like stars on a combat arena floor: shuriken shapes, yin-yang micro-icons, concentric hex ripples.

**Sci-Fi HUD Motifs:**

The entire site is overlaid with a persistent HUD layer rendered in CSS/SVG:

- **Targeting Reticle:** A large, semi-transparent crosshair (constructed from four `<line>` elements and a `<circle>` in SVG) that follows the user's scroll position, always centered on the currently active hex cluster. The reticle uses `stroke: #2A8B7A` with `stroke-dasharray` animation to simulate a scanning/locking effect. When a hex is "locked" (hovered or in viewport center), the reticle contracts and flashes `#F5C842` briefly.

- **Edge Brackets:** Each corner of the viewport has L-shaped bracket overlays (position: fixed) rendered in thin `#C4973B` lines, simulating the frame boundaries of a cockpit display. These brackets contain small Share Tech Mono readouts that update on scroll: current section name, scroll percentage, a fake "threat level" that increases as the user scrolls deeper.

- **Scan Lines:** A subtle horizontal scan-line effect achieved with a repeating-linear-gradient overlay (`repeating-linear-gradient(0deg, transparent, transparent 2px, rgba(196, 151, 59, 0.03) 2px, rgba(196, 151, 59, 0.03) 4px)`) applied as a pseudo-element over the entire page. This creates the faintest CRT/HUD scan-line texture without impacting readability.

- **Hex Grid Underlay:** Behind all content, a faint honeycomb wireframe pattern (SVG `<pattern>` element) tiles the entire background in `#C4973B` at 5% opacity, establishing the hexagonal geometry as a pervasive environmental texture. This wireframe subtly parallax-scrolls at 0.3x the scroll speed, creating depth.

**McBling Embellishments:**

- **Rhinestone Borders:** Select hexagonal cells (hero sections, key content) have borders that shimmer with a rhinestone effect: small circular `radial-gradient` dots placed at regular intervals along the hex perimeter using a `background-image` stack, each dot cycling through a sparkle animation (opacity 0.3 to 1.0 to 0.3 at staggered intervals), creating a diamond-like twinkle.

- **Glossy Surfaces:** Key hexagonal cards use a glossy finish achieved with a `linear-gradient(135deg, rgba(255,255,255,0.15) 0%, rgba(255,255,255,0) 50%)` overlay, simulating the reflective plastic surface of a bedazzled phone case. On hover, this gloss-line sweeps across the surface (translateX animation) like light catching a jewel.

- **Particle Trails:** Mouse movement triggers a trail of tiny hexagonal particles (8px each, `#F5C842` with blur) that follow the cursor with spring physics (decaying velocity), leaving a brief golden afterglow. The particles are rendered in a canvas overlay with requestAnimationFrame for performance.

## Prompts for Implementation

**Full-Screen Narrative HUD Experience:**

The site opens to a full-viewport "boot sequence." The screen is `#1A1208` (charred parchment dark). After a 300ms pause, the hex grid underlay fades in at 5% opacity. Then the corner bracket HUD elements draw themselves on-screen using `stroke-dashoffset` animation (700ms). Then the central targeting reticle appears with a contracting-circle animation (scaling from 3x to 1x with elastic easing). Finally, the first hex cluster assembles itself: individual hexagons fly in from off-screen edges, each arriving with a distinct trajectory and a micro-shake on landing. The domain name "martial.quest" appears character by character in Playfair Display 900 inside the central hex, each letter accompanied by a brief amber flash. Total boot sequence: 2.5 seconds. No skip button -- this is the experience.

**Scroll-Driven Combat Progression:**

As the user scrolls, the hexagonal grid reorganizes: new clusters of hexagons assemble from the edges, old ones shrink and fade to the periphery. Each section transition is not a simple fade or slide but a **tactical redeployment**: hexagons detach from one formation and reattach in a new configuration, like units on a battlefield map repositioning. Use GSAP ScrollTrigger or Intersection Observer with custom timeline management. Each hex has a unique entry: some spiral in, some slam down with a shake, some materialize with a scan-line wipe.

**Shake-Error as Combat Impact:**

The shake-error animation pattern is recontextualized entirely. Rather than indicating form validation failure, shake is used as a **combat impact effect**. When content elements enter the viewport, they arrive with a decisive 200ms horizontal shake (3px amplitude, 3 oscillations) that communicates the impact of a strike landing. On hover over key interactive hexagons, a micro-shake (1px, 2 oscillations, 100ms) suggests the contained energy of a fighter in a ready stance. On click/tap, a sharp vertical shake (4px, single pop) confirms the action like a satisfying hit connecting. CSS implementation: `@keyframes combatShake { 0%, 100% { transform: translateX(0); } 25% { transform: translateX(-3px); } 50% { transform: translateX(3px); } 75% { transform: translateX(-1px); } }`.

**Hexagonal Hover Choreography:**

When a user hovers over any hexagonal cell, the cell itself scales to 1.05x and increases border glow intensity, but the surrounding hexagons also respond: the immediate 6 neighbors (in the honeycomb topology) each rotate 5 degrees toward the hovered cell and shift 2px closer, as if magnetically attracted. This creates a breathing, organic response where the entire grid reacts to user attention. Achieved through CSS sibling selectors and custom `data-hex-row` / `data-hex-col` attributes that enable topological neighbor targeting in JavaScript.

**Icon Animation System:**

Each icon within a hexagonal cell has a two-phase animation:
1. **Entry Phase:** The base silhouette layer fades in first (200ms), then the wireframe overlay draws itself on top using `stroke-dashoffset` from full dash length to 0 (400ms), creating a "holographic projection" effect.
2. **Idle Phase:** The wireframe overlay gently oscillates in position (±1px on both axes, 4s cycle) relative to the silhouette base, maintaining the holographic depth illusion. On hover, the oscillation amplitude increases to ±3px and the wireframe shifts to `#F5C842` (plasma amber), simulating a HUD lock-on.

**AVOID:**
- CTA-heavy layouts (no "Sign Up Now" buttons, no pricing blocks, no feature comparison tables)
- Stat-grids and dashboard metrics (the HUD numerals are decorative/narrative, not functional data)
- Conventional navigation bars, hamburger menus, or footer link blocks
- Stock photography or realistic imagery of any kind
- Flat, static layouts with no spatial depth or animation
- Generic card-based layouts that ignore the hexagonal constraint

## Uniqueness Notes

**Differentiators from other designs:**

1. **McBling Aesthetic (0% frequency):** This is the first design in the entire portfolio to use the McBling aesthetic. McBling -- the rhinestone-encrusted, glossy, maximalist visual culture of 2004-2008 pop celebrity -- has never been applied to any other site. The combination of rhinestone sparkle effects, glossy plastic surface treatments, and bedazzled border decorations creates a visual language that is entirely absent from all 216 existing designs.

2. **Hexagonal Honeycomb Layout (1% frequency):** Only 1% of designs use hexagonal layouts. This design makes the hexagon the fundamental structural unit of the entire page, not merely a decorative accent. Every content container, navigation element, icon frame, and interactive surface is hexagonal. The honeycomb is not ornamental -- it is architectural, defining the site's spatial logic at every scale from the 6-hex radial nav to the full-page tessellation.

3. **Shake-Error Pattern Recontextualized as Combat Impact (1% frequency):** Shake animations appear in only 1% of existing designs, and exclusively in their conventional form-validation context. This design repurposes shake as a kinesthetic communication of martial impact -- entry shakes, hover trembles, click pops. The pattern becomes a core interaction vocabulary rather than an edge-case error state.

4. **Icon-Heavy Imagery Without Photography (1% frequency):** Only 1% of designs prioritize icon-heavy imagery. This design uses zero photographs, zero illustrations, zero abstract blobs. Every visual element is an icon or a HUD motif, creating a purely symbolic visual language that communicates through glyphs rather than depiction.

5. **Sci-Fi HUD Motifs Merged with McBling (1% frequency):** The fusion of sci-fi HUD overlay elements (targeting reticles, scan lines, edge brackets, tactical readouts) with McBling's rhinestone glamour is a collision that exists nowhere else in the portfolio. The HUD provides structural rigor and tactical precision; the McBling provides warmth, flash, and personality. Together they create an aesthetic that is simultaneously disciplined and extravagant.

6. **Sepia-Nostalgic Palette Applied to Futuristic Interface (6% frequency):** While sepia palettes exist at 6%, they are always applied to historical, archival, or vintage contexts. Here, sepia is applied to a sci-fi HUD interface, creating a temporal paradox: the interface of the future viewed through the color temperature of the past, as if this combat display was recovered from a time capsule and is displaying on degraded equipment.

**Chosen Seed:**
- aesthetic: mcbling
- layout: hexagonal-honeycomb
- typography: playfair-elegant
- palette: sepia-nostalgic
- patterns: shake-error
- imagery: icon-heavy
- motifs: sci-fi-hud
- tone: energetic

**Avoided Overused Patterns:**
- playful aesthetic (95%) -- replaced with mcbling (0%)
- centered layout (99%) -- replaced with hexagonal-honeycomb (1%)
- mono typography (99%) -- Share Tech Mono used only for HUD accents, not as primary type
- warm palette (100%) -- sepia-nostalgic is warm-adjacent but specifically nostalgic rather than generically warm
- scroll-triggered patterns (97%) -- present but subordinate to shake-error as the primary interaction pattern
- minimal imagery (93%) -- replaced with icon-heavy (1%)
- vintage motifs (81%) -- replaced with sci-fi-hud (1%)
- friendly tone (98%) -- replaced with energetic (8%)
<!-- DESIGN STAMP
  timestamp: 2026-03-10T15:29:32
  domain: martial.quest
  seed: seed:
  aesthetic: martial.quest lives in the collision between a mid-2000s McBling nightclub VIP r...
  content_hash: 9800e5a9eafa
-->
