# Design Language for martial.quest

## Aesthetics and Tone

martial.quest embodies the philosophy of *budo* — the martial way — translated into a digital space that feels like stepping into a dojo of pure intention. The aesthetic merges Japanese minimalism with a deep, blood-tinged luxuriousness: the kind of beauty found in a perfectly folded gi, an aged katana resting in its stand, or a brush-ink calligraphy scroll mounted on a lacquered wall.

The tone is **opulent and contemplative simultaneously** — not boastful luxury, but earned refinement. Think of a grandmaster's private training hall: sparse, deliberate, every object chosen with absolute purpose. Nothing decorates; everything signifies.

The visual mood draws from:
- Edo-period woodblock prints (*ukiyo-e*) with their dramatic negative space and cropped compositions
- The austere beauty of Zen rock gardens where empty space is the subject
- High-end Japanese whisky packaging — deep burgundy lacquer, matte gold foil, whisper-thin serif type
- Black-and-white photography of martial artists shot mid-motion, grain amplifying tension

This is not a sport site. It is a temple. The visitor should slow their breath when they arrive.

## Layout Motifs and Structure

The grid breaks purposefully, like a kata interrupted — each section composed with deliberate asymmetry that creates visual tension without chaos. Inspired by *ma* (間), the Japanese concept of negative space as meaningful presence.

**Structural principles:**

- **Hero section:** Full viewport height, almost entirely void. A single large Bebas Neue heading floats upper-left at massive scale (18–24vw), while a single grain-overlaid image bleeds off the right edge occupying roughly 40% viewport width. The text and image do not align — they exist in separate gravitational fields.

- **Content sections:** An asymmetric two-track layout — one track is 65% width, offset 8% from left; the secondary track is 25% width, anchored to the far right with a subtle vertical rule (#5c1020 at 1px opacity 30%) separating the columns. Columns intentionally misalign vertically by 80–120px.

- **Feature panels:** Full-bleed horizontal bands where text is anchored bottom-left and imagery bleeds from center-right, with a soft blur vignette transitioning the image into the dark background. Text never overlaps imagery — they breathe beside each other.

- **Navigation:** Minimal floating vertical nav on the right side — small Bebas Neue labels rotated 90 degrees, in deep burgundy. No hamburger menus. No excessive links. Five items maximum.

- **Whitespace:** Generous top/bottom padding (min 120px sections). Content should feel isolated, meditative. Each section is a pause before the next movement.

## Typography and Palette

### Typefaces

**Primary Display:** Bebas Neue (Google Fonts)
- Used at extremes: either enormous (14–24vw for hero headlines) or very small (10–11px for labels/captions)
- Tracking: -0.02em for large display, +0.15em for small labels
- Never used at medium sizes — the contrast between scales is the design

**Secondary Body:** Cormorant Garamond (Google Fonts)
- Light weight (300) for body text, creating an aristocratic thinness
- Italic variant for pull quotes and emphasized passages
- Size: 16–18px body, 24–32px for sub-headings
- Tracking: +0.01em

**Accent/Micro:** IBM Plex Mono (Google Fonts)
- For timestamps, codes, technical details, small navigation labels
- Size: 10–12px, tracking +0.08em
- Creates a subtle modernist counterpoint to the historical weight of the other faces

### Color Palette

| Role | Name | Hex |
|------|------|-----|
| Background Primary | Lacquer Black | `#0a0506` |
| Background Secondary | Deep Charcoal | `#120b0d` |
| Primary Accent | Blood Lacquer | `#6b0f1a` |
| Secondary Accent | Aged Burgundy | `#8b1a2a` |
| Highlight | Muted Crimson | `#c0293e` |
| Surface | Dark Burgundy Surface | `#1a0810` |
| Text Primary | Aged Paper White | `#f0e6d3` |
| Text Secondary | Warm Ash | `#9e8a7a` |
| Rule/Border | Whisper Burgundy | `#3d0f18` |
| Gold Accent | Burnished Gold | `#c9a84c` |

**Color usage:** The background should feel like aged lacquer — not pure black but warm, deep, slightly reddish black. The burgundy palette should appear in selective touches: a line, a hover state, a decorative rule. The burnished gold appears only for singular emphasis — a single word, a seal mark, a border on a featured element.

## Imagery and Motifs

### Grain Overlay System

Every image carries a consistent grain overlay — a noise texture at 60–80% opacity in Multiply mode creates the feeling of aged silver gelatin photography. This unifies all imagery under a single patina. No clean digital photos; every image must feel like it has witnessed decades.

The grain texture is an SVG noise filter applied via CSS `filter` with a custom feturbulence frequency of 0.65, combined with a semi-transparent dark vignette on all four edges.

### Imagery Direction

- **Martial arts photography:** black-and-white or deeply desaturated, shot with dramatic directional lighting — a single light source creating deep shadows. Subjects are often cropped aggressively: a hand gripping a sword hilt, feet planted in stance, the arc of a throwing motion caught at peak tension.
- **Calligraphy and ink:** Brush strokes used as background elements — large, gestural, 8–15% opacity in a warm burgundy — they read as texture before they read as symbol.
- **Geometric motifs:** Thin-line Japanese family crests (*mon*) used as watermark decorations. A circle motif (enso) appears as a section divider, drawn in thin gold stroke at 20% opacity.
- **Material textures:** Subtle washi paper grain in background sections, achieved with CSS background noise; aged silk texture on surface cards.

### Decorative System

- Thin horizontal rules (1px, #3d0f18, 40% opacity) mark section boundaries
- A vertical `|` rule in burnished gold (#c9a84c, 60% opacity, 1px) marks pull-quotes and featured text
- Japanese seal marks (hanko-style square with inner character) used as section anchors, rendered in SVG, approximately 32x32px
- Enso circles (incomplete brush-stroke rings) as decorative punctuation between major content blocks

## Prompts for Implementation

### Overall Architecture

Build this as a single-page vertical scroll experience. No page transitions — the scroll itself is the journey. Sections should feel like moving through different chambers of a dojo, each with its own atmosphere but unified by the consistent palette and grain.

### Hero Section

```
Full-viewport hero with:
- Background: #0a0506 solid, with a washi paper SVG noise texture at 8% opacity
- Bebas Neue heading "MARTIAL.QUEST" split across two lines, white #f0e6d3,
  font-size clamp(60px, 18vw, 220px), positioned top-left with padding-left: 6vw,
  padding-top: 15vh
- A single image (martial arts silhouette or calligraphy) positioned absolutely
  right: -2vw, top: 0, height: 100vh, width: 45vw, object-fit: cover
  with grain overlay filter and a left-edge gradient fade to #0a0506
- Blur-focus reveal on page load: hero image starts at blur(12px) opacity 0,
  animates to blur(0px) opacity 1 over 1.8s with cubic-bezier(0.16, 1, 0.3, 1)
- The heading animates in from left (translateX(-40px)) simultaneously
- A single Cormorant Garamond italic subtitle, 18px, #9e8a7a, bottom-left:
  "The way is found through practice."
- Vertical scroll indicator: thin vertical line (#6b0f1a) with an animated
  descending dot, bottom-center
```

### Blur-Focus Interaction Pattern

```
Applied throughout as a scroll-triggered reveal system:
- All content sections start as filter: blur(6px) opacity: 0
- As section enters viewport (IntersectionObserver, threshold 0.15),
  animate to filter: blur(0px) opacity: 1
- Duration: 0.9s, timing: cubic-bezier(0.25, 0.46, 0.45, 0.94)
- Stagger child elements by 80ms using CSS animation-delay
- The blur-to-focus metaphor mirrors the martial arts concept of "zanshin" —
  the lingering awareness after technique
```

### Navigation

```
Fixed vertical right-side navigation:
- position: fixed, right: 32px, top: 50%, transform: translateY(-50%)
- Five nav items: PHILOSOPHY, PRACTICE, LINEAGE, JOURNAL, CONNECT
- Bebas Neue, 11px, letter-spacing: 0.15em, writing-mode: vertical-rl
- Default color: #3d0f18, hover: #c0293e
- Active section indicator: a 1px horizontal gold line (#c9a84c) 
  extending 24px leftward from the active nav item
- No background, no borders — pure floating type
```

### Content Sections

```
Philosophy Section:
- 65vw content block, offset-left: 8vw
- Large Bebas Neue section number "01" at 20vw, top-right, color #1a0810
  (barely visible — a ghost number)
- Cormorant Garamond body 18px leading 1.8, #f0e6d3
- Pull quote in italic, 28px, left-bordered with 1px gold rule
- Brushstroke SVG decoration, 10% opacity burgundy, absolutely positioned
  behind text

Practice Section:
- Asymmetric card layout: two cards at 40% width each, offset vertically by 80px
- Cards have background #120b0d, subtle 1px border #3d0f18
- On hover: border transitions to #6b0f1a, slight translateY(-4px),
  background shifts to #1a0810
- Each card carries a grain-overlay image header (200px tall)

Lineage Section:
- Full-bleed dark band (#120b0d)
- Japanese-style timeline: vertical center line in #3d0f18
- Nodes are enso circles (24px, thin gold stroke)
- Year labels in IBM Plex Mono, right of line; event text in Cormorant Garamond, left
```

### Animation and Interaction Details

```
Blur-Focus Scroll Reveals:
- Implement with IntersectionObserver
- Each observed element: initial style="filter:blur(6px);opacity:0;transform:translateY(20px)"
- On intersection: transition all 0.9s cubic-bezier(0.25,0.46,0.45,0.94)
- Remove blur, opacity to 1, translateY to 0

Image Hover States:
- All images: transition filter 0.6s
- Hover: slight brightness(1.1) and contrast(1.05)
- The grain overlay remains constant — only underlying image brightens

Gold Accent Reveals:
- Gold lines/borders draw in via clip-path: inset(0 100% 0 0) → inset(0 0% 0 0)
- Duration: 0.8s, ease-out, triggered on scroll
- Creates the impression of a calligrapher's brush stroke drawing itself

Cursor:
- Custom cursor: 16px circle, #c9a84c, mix-blend-mode: difference
- On hover over interactive elements: scales to 32px, fills with #6b0f1a at 40% opacity
```

### Performance and Polish

```
CSS Variables for the entire palette — easily adjustable theming:
:root {
  --bg-primary: #0a0506;
  --bg-secondary: #120b0d;
  --accent-primary: #6b0f1a;
  --accent-secondary: #8b1a2a;
  --highlight: #c0293e;
  --text-primary: #f0e6d3;
  --text-secondary: #9e8a7a;
  --gold: #c9a84c;
  --rule: #3d0f18;
}

Grain texture via SVG filter (no external images needed):
<filter id="grain">
  <feTurbulence type="fractalNoise" baseFrequency="0.65" numOctaves="3" stitchTiles="stitch"/>
  <feColorMatrix type="saturate" values="0"/>
  <feBlend in="SourceGraphic" mode="multiply"/>
</filter>
Applied as: filter: url(#grain)
```

## Uniqueness Notes

**Three or more differentiators from other designs:**

1. **Dual-register typography with intentional scale gaps:** Bebas Neue is deployed only at extremes — massive display (18–24vw) and micro-label scale (10–11px). This creates a radical typographic hierarchy where medium sizes are completely absent, forcing the eye to jump between the monumental and the intimate — mirroring the dynamic range of martial arts itself.

2. **Blur-as-philosophy interaction metaphor:** The `blur-focus` animation pattern is not merely decorative — it is explicitly tied to the concept of *zanshin* (remaining awareness) and *mushin* (empty mind). Each section reveals itself as if the viewer's focus is sharpening, making the interaction a tactile expression of the domain's philosophy rather than a generic reveal effect.

3. **Ghost number underlayer:** Massive ghost numerals (section numbers at 20vw, in an almost-invisible near-black #1a0810 against the #0a0506 background) create subliminal depth — visible only when the eye adjusts to the dark field, like shapes emerging from shadow in a low-lit dojo.

4. **Japanese *mon* (family crest) integration as functional wayfinding:** Traditional Japanese seal/crest motifs serve as section anchors and decorative punctuation rather than purely ornamental elements. The enso (Zen brush circle) doubles as section divider and philosophical punctuation — a rare case of cultural motif with direct functional meaning.

5. **Warm-black lacquer backgrounds instead of pure black:** The background color `#0a0506` is subtly warm and reddish-black, evoking aged Japanese lacquerware rather than digital darkness. This single decision shifts the entire palette from cold/tech to organic/historical without any additional design effort.

**Chosen seed/style:** aesthetic: japanese-minimal, layout: broken-grid, typography: bebas-bold, palette: deep-burgundy, patterns: blur-focus, imagery: grain-overlay, motifs: vintage, tone: luxurious

**Avoided patterns from frequency analysis:**
- Avoided `art-deco-display` (5% — most overused typography pattern)
- Avoided `oversized-display` as a standalone choice (4%) — instead integrated scale extremes into a dual-register system unique to this design
- Avoided `serif-revival` (4%) despite the serif-heavy palette — Cormorant Garamond is used as a supporting voice, not the typographic lead
- Underused `kinetic-animated` and `playfair-elegant` patterns were deliberately not chosen in favor of the assigned seed vocabulary
<!-- DESIGN STAMP
  timestamp: 2026-05-08T22:54:41
  domain: martial.quest
  seed: vocabulary
  aesthetic: martial.quest embodies the philosophy of *budo* — the martial way — translated i...
  content_hash: ba176b2887b9
-->
