# Design Language for mujun.xyz

## Aesthetics and Tone

mujun.xyz channels the surreal calm of a Magritte painting transplanted into a Himalayan dawn -- impossible landscapes rendered with the reverence and softness of a hand-written letter from a friend who lives above the clouds. The word "mujun" evokes contradiction and paradox, and the design leans into that: pristine mountain vistas where the peaks bend gently like calligraphy strokes, skies that shift from apricot to lavender in ways that feel not quite real but deeply comforting.

The tone is **optimistic-bright** -- not saccharine or corporate-cheerful, but the genuine warmth of morning sun through a kitchen window. Everything feels handmade, as if the entire page were written on thick cream-colored card stock with a brush pen. There is no irony here, no detachment. The mood is sincere wonder: the kind of feeling you get standing at a ridge line at 5 AM watching the world assemble itself out of mist.

Visual inspirations: the soft surrealism of Remedios Varo's floating architectures, the golden-hour photography of Hiroshi Sugimoto's seascapes (but transposed to mountains), the hand-lettered title cards of Wes Anderson films, and the paper-craft aesthetics of traditional Korean hanji art.

## Layout Motifs and Structure

The layout is **hero-dominant** -- a single, vast opening canvas that consumes the entire viewport and refuses to let go until the viewer has truly absorbed the scene. The hero is not a photograph with overlaid text; it is a living, breathing tableau where layered CSS gradients simulate the atmospheric perspective of mountain ranges receding into golden haze.

**Vertical Narrative Architecture:**

- **Hero Pane (100vh):** A full-viewport scene depicting an abstract mountain silhouette layered in three tiers of decreasing opacity. The foreground ridge is rendered as a CSS clip-path with gentle, hand-drawn irregularity. Behind it, a mid-ground range at 60% opacity, then a far range at 30%. The sky above uses a radial gradient from warm amber (#D4A574) at the horizon to soft lavender (#C4B0D4) at the zenith. A single handwritten line of text floats near the center, positioned at the golden ratio (61.8% from bottom). No navigation bar -- navigation appears only on scroll.

- **Transition Zone (50vh):** As the user scrolls past the hero, the mountain silhouettes perform a slow parallax separation -- foreground moving faster, background barely drifting -- creating an illusion of the viewer ascending through the scene. The sky gradient shifts subtly toward noon warmth.

- **Content Islands:** Below the hero, content is arranged as isolated "islands" -- self-contained text blocks with generous negative space (minimum 120px between islands). Each island is slightly rotated (0.3deg to 0.8deg alternating directions) to break mechanical alignment and evoke the feeling of handwritten notes pinned to a corkboard. Islands are max-width 640px, left-aligned with a 15% left margin on desktop, creating an asymmetric river of whitespace on the right.

- **Breathing Gutters:** Between content islands, subtle CSS-only mountain silhouette dividers appear -- thin, single-color ridge lines rendered with SVG paths that echo the hero's topography but at a smaller scale, like doodles in a journal margin.

- **Footer as Valley:** The page ends not with a conventional footer but with a "descent" -- the background gradient warms to deep honey (#B8860B fading to #F5E6D0) as if the viewer has descended into a sunlit valley. The final content island contains only a single handwritten farewell phrase.

## Typography and Palette

**Typography:**

- **Headlines / Hero Text:** "Caveat" (Google Fonts) -- a natural handwriting face with genuine pen texture and lively baseline variation. Used at 3.5rem-7rem for the hero statement, 2.5rem-3.5rem for section headings. Weight: 700. The slight wobble of Caveat's letterforms reinforces the hand-drawn, personal quality of the design.

- **Body Text:** "Nunito Sans" (Google Fonts) -- a clean, warm humanist sans-serif that pairs beautifully with Caveat's organic energy. Its rounded terminals soften the reading experience without sacrificing legibility. Used at 1.1rem-1.25rem for body copy, line-height 1.85 for generous vertical rhythm. Weight: 400 regular, 600 for emphasis.

- **Accent / Marginalia:** "Kalam" (Google Fonts) -- a more casual handwriting font with a ballpoint-pen quality, used sparingly for captions, annotations, and the small decorative text that appears alongside mountain ridge dividers. Used at 0.85rem-1rem. Weight: 400.

**Typographic Details:**
- All headlines use `letter-spacing: 0.02em` and `word-spacing: 0.08em` for an airy, breathable feel
- Body text uses `text-rendering: optimizeLegibility` and `font-feature-settings: 'liga' 1, 'kern' 1`
- Pull quotes are set in Caveat at 2rem with a vertical honey-colored (#D4A574) bar on the left, 3px wide
- No uppercase transforms anywhere -- the entire site speaks in sentence case, maintaining the intimacy of handwriting

**Color Palette (Honeyed-Neutral):**

| Role | Color | Hex |
|------|-------|-----|
| Background (primary) | Warm Cream | #FAF6F0 |
| Background (hero sky - horizon) | Golden Amber | #D4A574 |
| Background (hero sky - zenith) | Soft Lavender | #C4B0D4 |
| Mountain foreground | Warm Umber | #6B5B4F |
| Mountain mid-ground | Dusty Mauve | #9C8B80 |
| Mountain far-ground | Haze Blush | #D1C4B8 |
| Text (primary) | Deep Walnut | #3D3229 |
| Text (secondary) | Warm Stone | #7A6E63 |
| Accent (links, highlights) | Honey Gold | #C4943A |
| Accent (hover state) | Deep Honey | #A67B2E |
| Divider lines / ridges | Pale Terracotta | #C9A88E |
| Footer valley gradient end | Butter Linen | #F5E6D0 |

The palette draws from the golden hour color spectrum -- every color exists within the narrow band between amber and mauve that appears when sunlight filters through mountain atmosphere. There are no cool blues, no sharp whites, no blacks. Everything is warm, softened, as if seen through honey-tinted glass.

## Imagery and Motifs

**Mountain-Landscape as CSS Art:**
The primary visual motif is mountain ridgelines, but never as photographs. All mountains are constructed from CSS clip-paths and SVG path elements, creating abstract silhouettes that suggest topography without depicting it literally. Each ridgeline is unique -- generated from hand-plotted bezier curves with control points that create the natural irregularity of real mountain profiles. At least 5 distinct ridge profiles are used throughout the page, never repeated.

**Surreal Atmospheric Effects:**
- **Floating Ink Dots:** Small circles (4-8px) in Honey Gold (#C4943A) at 30-50% opacity drift slowly across sections using CSS keyframe animations. They move at different speeds (60s-120s cycle times) and different vertical positions, suggesting golden dust motes caught in mountain sunlight. Maximum 8-12 dots visible at any time -- enough to notice, never enough to distract.

- **Impossible Shadows:** Content islands cast shadows that don't match their geometry -- a rectangular text block might cast an oval shadow rotated 15 degrees, or a shadow that falls upward. This subtle surrealist touch rewards close observation. Achieved with CSS `filter: drop-shadow()` using unconventional offset values.

- **Horizon Bleed:** At the junction of the hero and the first content island, the mountain silhouette's gradient "bleeds" downward into the content area, as if the landscape is dissolving into the page. This is achieved with a positioned pseudo-element that carries the gradient and fades to transparent over 200px.

**Handwritten Annotations:**
Small text fragments in Kalam appear in the margins -- not as functional labels but as ambient text, like someone scribbled notes while contemplating the view. These are positioned absolutely, rotated 2-5 degrees, and rendered at 40-60% opacity. Content could include fragments like coordinates ("34.7N, 138.4E"), altitude marks ("2,847m"), or single poetic words ("stillness", "ridge", "dawn").

**Pulse-Attention Micro-Interactions:**
Key interactive elements use a gentle pulse animation -- a subtle scale oscillation (1.0 to 1.02 and back) over 3 seconds with an ease-in-out curve. This is applied to the hero text on initial load (runs twice then stops), to link hover states (continuous while hovered), and to the final farewell text in the footer valley. The pulse is barely perceptible -- it should feel like breathing, not throbbing.

## Prompts for Implementation

**Full-Screen Narrative Experience:**
The entire site is a scroll-driven journey from mountain summit to sunlit valley. There is no navigation menu on initial load -- only the vast hero landscape and the handwritten invitation to scroll. Navigation (if needed) materializes as a minimal fixed element after the user scrolls past the hero: just the domain name "mujun.xyz" in Caveat at 1.2rem, positioned top-left with 60% opacity, acting as a home anchor.

**Hero Construction (CSS-Only Mountains):**
```
The hero uses three layered div elements, each with a clip-path polygon defining a unique ridge profile:
- Layer 1 (foreground): clip-path with 12-16 points, color #6B5B4F
- Layer 2 (mid-ground): clip-path with 10-14 points, color #9C8B80, offset 15% higher
- Layer 3 (far-ground): clip-path with 8-12 points, color #D1C4B8, offset 30% higher
- Behind all layers: radial-gradient background simulating sky
- All layers use position: absolute within a 100vh container
```

**Scroll-Triggered Behaviors:**
- Hero mountain layers parallax-separate on scroll using `transform: translateY()` driven by scroll position (IntersectionObserver + requestAnimationFrame, not scroll event listeners)
- Content islands fade-in with a 30px upward translation when they enter the viewport, using CSS transitions triggered by an `.visible` class added via IntersectionObserver with `threshold: 0.15`
- Mountain ridge dividers draw themselves left-to-right using SVG stroke-dasharray animation when scrolled into view
- The footer valley gradient intensifies as the user approaches the bottom of the page

**Animation Philosophy:**
All animations are slow, deliberate, and organic. No easing function should be sharper than `cubic-bezier(0.25, 0.1, 0.25, 1.0)`. Typical durations: 800ms-1500ms for transitions, 3000ms-5000ms for ambient loops. Nothing should snap, bounce, or overshoot. Everything breathes.

**Storytelling Arc:**
The page tells the story of a single day on a mountain: the hero is dawn, the first content islands are morning (bright, warm, active), the middle section is midday (the most information-dense area), and the footer is sunset/descent. The background cream color warms gradually as the user scrolls -- starting at #FAF6F0 (cool cream) at the top and ending at #F5E6D0 (butter linen) at the bottom. This shift is achieved with a very tall linear-gradient on the body element.

**AVOID:**
- CTA buttons, pricing blocks, stat-grids, testimonial carousels
- Sharp corners on any element (minimum border-radius: 2px on all containers)
- Pure black (#000000) or pure white (#FFFFFF) anywhere
- Stock photography or raster images (everything is CSS/SVG)
- Loading spinners (use skeleton placeholders in the honeyed palette if needed)
- Hamburger menus or traditional navigation patterns
- Any animation faster than 600ms

## Uniqueness Notes

**Differentiators from other designs:**

1. **CSS-Only Mountain Topography:** No other design in the portfolio constructs its primary visual identity from CSS clip-path mountain silhouettes. While nature motifs appear at 29% frequency, they are almost always photographic or illustrative. Here, the mountains are pure geometry -- clip-paths and SVG paths that create the atmosphere of landscape through abstraction alone. This aligns with the surreal aesthetic (2% frequency) by making the familiar strange.

2. **Handwritten-Voice Narrative Architecture:** The combination of handwritten typography (Caveat + Kalam) with a hero-dominant layout (4% frequency) creates an intimate, letter-like reading experience that no other design achieves. Most hero-dominant layouts use bold display type for impact; this one uses handwriting for warmth, creating a paradox of grand scale and personal intimacy that embodies the "mujun" (contradiction) in the domain name.

3. **Dawn-to-Dusk Chromatic Journey:** The page-length gradient shift from cool cream to warm butter -- synchronized with the narrative arc from mountain summit to valley floor -- creates a temporal experience unique in the portfolio. The honeyed-neutral palette (2% frequency) is treated not as a static color scheme but as a living gradient that tells the time of day. Combined with the optimistic-bright tone (1% frequency), this produces a design that literally brightens as you scroll deeper.

4. **Surreal Shadow Geometry:** The deliberately mismatched shadows on content islands (oval shadows on rectangular elements, upward-falling shadows) introduce a quiet surrealism that operates below conscious attention. This is not glitch art or obvious distortion -- it is the uncanny-valley of shadow physics, where something feels slightly impossible without being identifiable. No other design in the portfolio employs this technique.

5. **Impossible Stillness with Breath:** The pulse-attention pattern (5% frequency) is used not for urgency or notification but for meditation -- elements gently breathe at a 3-second cycle, suggesting the page itself is alive and resting. Combined with the floating ink-dot particles and the near-imperceptible parallax, the page achieves a state of animated stillness that recalls the experience of sitting quietly in a real landscape.

**Chosen Seed:** aesthetic: surreal, layout: hero-dominant, typography: handwritten, palette: honeyed-neutral, patterns: pulse-attention, imagery: minimal, motifs: mountain-landscape, tone: optimistic-bright

**Avoided Overused Patterns:**
- playful aesthetic (95%) -- replaced with surreal (2%)
- centered layout (99%) -- replaced with hero-dominant (4%) and asymmetric content islands
- friendly tone (98%) -- replaced with optimistic-bright (1%)
- vintage motifs (84%) -- replaced with mountain-landscape (2%)
- mono typography (99%) -- replaced with handwritten (19%)
- warm palette (100%) -- narrowed to honeyed-neutral (2%), a specific warm sub-palette
- scroll-triggered patterns (97%) -- still present but subordinated to pulse-attention (5%)
- photography imagery (73%) -- replaced with minimal CSS/SVG-only approach
<!-- DESIGN STAMP
  timestamp: 2026-03-10T16:16:50
  domain: mujun.xyz
  seed: seed:
  aesthetic: mujun.xyz channels the surreal calm of a Magritte painting transplanted into a H...
  content_hash: 4845d76fc5b1
-->
