# Design Language for xanadu.quest

## Aesthetics and Tone
xanadu.quest evokes Samuel Taylor Coleridge's mythical pleasure dome through a glassmorphism aesthetic -- translucent, frosted panels floating over a warm terracotta-tinted landscape, like looking at a utopian city through rain-streaked glass. The visual identity merges the literary mystique of Xanadu (the dream poem, the Citizen Kane estate, Ted Nelson's hypertext project) with the crisp translucency of modern glass UI. The tone is authoritative and scholarly -- a quest for the ideal that takes itself seriously while acknowledging its own impossibility. Inspiration from frosted glass architecture (Apple Park, Louvre Pyramid), Romantic-era landscape paintings, and the amber warmth of terracotta pottery from the Silk Road trade routes that connected to the real Xanadu.

## Layout Motifs and Structure
A **modular-blocks** layout where frosted-glass content modules can be mentally rearranged by the viewer, creating a "build your own Xanadu" reading experience.

**Primary structure:**
- **Dream entrance (100vh):** A warm terracotta gradient background (#3a2018 to #2a1810) with frost-effect particles (white dots at 0.1-0.3 opacity) drifting slowly. At center: a large frosted-glass panel (backdrop-filter: blur(16px), semi-transparent white) containing the title "XANADU QUEST" in clean frutiger-style type. Below the title: "In Xanadu did Kubla Khan / A stately pleasure-dome decree" in italic serif, fading at the edges.
- **Modular content grid:** Content presented in frosted-glass modules of varying sizes (2:1, 1:1, 1:2 aspect ratios) arranged in a responsive grid. Each module covers a different facet of "Xanadu" -- the poem, the historical site, the hypertext system, the cultural metaphor. Modules have thick frosted borders and subtle inner glow.
- **Abstract-tech connectors:** Between modules, thin glowing lines (1px, neon teal at 0.3 opacity) connect related concepts, creating a hypertext-inspired link visualization.
- **Counter-animate statistics:** Key numbers (dates, word counts, historical data) animate from 0 to their final value when scrolled into view, using a counter animation with easing.

**Spatial relationships:** Modular grid: CSS grid with auto-fill and minmax(280px, 1fr). Gap: 24px. Modules: padding 32px. Overall max-width: 1100px. Frosted panels overlap background by 0px (flat, no elevation shadows -- the frost effect IS the depth cue).

## Typography and Palette
**Fonts:**
- **Headlines:** "DM Sans" (Google Fonts) -- clean, geometric sans-serif with warm character, used at clamp(28px, 4vw, 56px). Weight 700. The Frutiger-inspired clarity cuts through the frosted surfaces with precision.
- **Body text:** "Literata" (Google Fonts) -- a variable serif designed for long-form reading at 17px/1.75 line-height. Weight 400 for body, 700 for emphasis. The literary serif honors the poetic origins of "Xanadu."
- **Data/Counters:** "Azeret Mono" (Google Fonts) -- a modern monospace at 20px for animated counter numbers. Weight 500. Clean numeral forms ensure counters are readable during animation.

**Color Palette:**
- **Background terracotta:** #3a2018 (deep warm brown)
- **Terracotta mid:** #5a3828 (medium brown for gradient midpoint)
- **Frost white:** rgba(255, 255, 255, 0.08) (translucent white for glass panels)
- **Frost border:** rgba(255, 255, 255, 0.15) (slightly more opaque for borders)
- **Text on frost:** #1a1410 (dark brown for text on glass panels)
- **Text on dark:** #e0d0c0 (warm cream for text on terracotta)
- **Neon teal:** #40c8b8 (accent for links, connectors, counters)
- **Highlight gold:** #d8a848 (warm gold for key emphasis)

## Imagery and Motifs
**Core visual motifs:**
- **Neon-glow accents:** Thin lines and small elements (link underlines, connector lines, counter numbers) rendered with neon teal glow (text-shadow: 0 0 8px #40c8b8, 0 0 16px #40c8b844). The glow represents the futuristic aspect of "Xanadu" -- technology illuminating history.
- **Abstract-tech connectors:** SVG lines with subtle glow connecting glassmorphic modules. Lines use stroke-dasharray: 6,6 and slowly animate stroke-dashoffset to create flowing connections. These evoke Ted Nelson's hypertext links.
- **Counter-animate numbers:** Key statistics (e.g., "1797" for Coleridge's poem, "1941" for Citizen Kane) count up from 0 on scroll intersection. Animation uses requestAnimationFrame with easing (ease-out-cubic) over 2s.
- **Frosted glass panels:** Modules use backdrop-filter: blur(16px) saturate(120%) with background: rgba(255,255,255,0.08) and border: 1px solid rgba(255,255,255,0.15). On hover: background brightens to rgba(255,255,255,0.12).

## Prompts for Implementation
**Utopian glass city experience:** The site should feel like wandering through a city of translucent buildings in a warm dusk light. Each glass module is a building you can peer into. The terracotta background is the landscape. The neon teal connectors are the streets.

**Glassmorphic module implementation:**
- .module { backdrop-filter: blur(16px) saturate(120%); background: rgba(255,255,255,0.08); border: 1px solid rgba(255,255,255,0.15); border-radius: 16px; padding: 32px; }
- .module:hover { background: rgba(255,255,255,0.12); transition: background 0.3s ease; }

**Counter animation:**
- Intersection Observer triggers on number elements.
- Use requestAnimationFrame loop: increment value from 0 to target over 2000ms.
- Easing: t = 1 - Math.pow(1 - progress, 3) (ease-out-cubic).
- Update textContent each frame.

**Connector lines:**
- SVG overlay with position: absolute, pointer-events: none.
- <line> elements connecting module centers.
- stroke: #40c8b8; stroke-opacity: 0.3; stroke-dasharray: 6,6;
- Animate stroke-dashoffset: -12 over 2s infinite linear.

**AVOID:** CTA-heavy layouts, pricing blocks, stat-grids, opaque backgrounds. Everything must maintain translucency.

## Uniqueness Notes
**Differentiators from other designs:**

1. **Glassmorphic modules as a utopian city metaphor:** Frosted-glass content panels on a warm landscape background create a unique "city of glass" visual narrative that connects the mythical Xanadu with modern translucent architecture.

2. **Hypertext connector lines between modules:** Glowing SVG lines connecting related content modules directly visualize Ted Nelson's Xanadu hypertext system -- making the design a meta-commentary on its own domain name.

3. **Counter-animated historical dates:** Statistics and dates that count up from zero when scrolled into view create a temporal journey -- watching years advance to their historical targets adds narrative tension to factual content.

**Chosen seed/style:** aesthetic: glassmorphism, layout: modular-blocks, typography: frutiger-clean, palette: terracotta-warm, patterns: counter-animate, imagery: neon-glow, motifs: abstract-tech, tone: authoritative

**Avoided overused patterns:** photography imagery (90%), centered layout (98%), card-grid layout (96%), warm palette (94% -- terracotta is specific), parallax patterns (99%), mono typography (81%), mysterious-moody tone (70%).
<!-- DESIGN STAMP
  timestamp: 2026-03-21T16:06:20
  domain: xanadu.quest
  seed: seed
  aesthetic: xanadu.quest evokes Samuel Taylor Coleridge's mythical pleasure dome through a g...
  content_hash: bd0da8914fe8
-->
