# Design Language for xanadu.wiki

## Aesthetics and Tone
xanadu.wiki channels a wabi-sabi aesthetic — the beauty of imperfection, the wisdom of impermanence, and the elegant acceptance of incompleteness that defines wabi-sabi philosophy applied to a comprehensive wiki documenting Xanadu — from Coleridge's poem to Ted Nelson's hypertext to every cultural reference to paradise. The site accepts — with the cracked-glaze beauty of kintsugi pottery, the weathered grace of aged wood temples, and the philosophical contentment of a wiki that embraces its own incompleteness because Xanadu itself was never finished. Inspiration draws from the wabi-sabi design philosophy of Leonard Koren's writings, the imperfect-beauty interiors of Axel Vervoordt, the traditional Japanese aesthetics of Tanizaki's In Praise of Shadows, and the collaborative knowledge architecture of Wikipedia's best historical articles. The tone is authoritative — commanding, definitive language that speaks with the certainty of deep scholarship, creating productive tension with the wabi-sabi acceptance of imperfection.

The wabi-sabi treatment transforms a wiki from sterile encyclopedic reference into a living, imperfect knowledge garden — articles showing visible revision marks like patina on aged surfaces, cross-references connecting like cracks in ancient pottery, and the wiki's ever-evolving nature celebrated as a feature rather than a limitation.

Each component carries wabi-sabi imperfect beauty — surfaces with subtle texture suggesting age and use, borders with slight irregularity, and color treatments that evoke natural materials rather than digital precision. The authoritative tone grounds this imperfection — definitive knowledge delivered through imperfect vessels.

## Layout Motifs and Structure
The layout uses a **broken-grid** architecture — intentionally disrupted grid creating the wabi-sabi quality of perfect order allowed to crack and shift naturally.

**Broken Grid System:**
- Base grid: 12-column at max-width: 1080px centered
- Content blocks: positioned on grid but with deliberate offsets (4-12px shifts)
- Feature sections: span irregular column counts (5 of 12, 7 of 12)
- Gap: 32px with occasional irregular spacing
- The broken grid creates the cracked-pottery quality of structure that has aged into beautiful imperfection

**Section Sequence:**
1. **Unfinished Palace:** Hero with geometric-sans typography on wabi-sabi textured ground, floating-elements suspended fragment motifs, blur-focus interactive imperfect-clarity engagement
2. **Knowledge Garden:** Wiki categories in broken-grid layout — blur-focus interactive selective-clarity with floating-elements suspended knowledge fragments
3. **Article Depths:** Detailed wiki content in generous offset reading layout with floating-elements orbiting reference markers and duotone-photo aged documentary imagery
4. **Cross-Reference Web:** Interconnected articles in broken-grid network with floating-elements minimal suspended accents
5. **Impermanence:** Footer as acceptance — authoritative farewell with floating-elements final fragments settling

**Spatial Philosophy:**
- Broken grid creates the wabi-sabi quality of structure that has been used and loved until it shows beautiful wear
- Deliberate offsets create the earthquake-shifted quality of perfect order disrupted by natural forces
- The unfinished-palace metaphor celebrates the wiki's perpetual incompleteness

## Typography and Palette
**Typography:**
- **Headlines:** "Space Grotesk" (Google Fonts) — geometric-sans at 2.0rem-2.8rem, weight 700. Its clean geometry creates productive tension with wabi-sabi visual imperfection.
- **Body Text:** "Crimson Text" (Google Fonts) — serif at 0.95rem, weight 400, line height 1.85.
- **Data:** "IBM Plex Mono" (Google Fonts) — monospace at 0.8rem for article metadata, revision dates, and reference numbers.
- **Labels:** "Space Grotesk" at 0.6rem, weight 600, uppercase, letter-spacing 0.14em.

**Color Palette:**
- **Void Black:** #0a0a0e — deep dark for primary background
- **Aged Panel:** #16161e — slightly lighter for card surfaces
- **Kintsugi Gold:** #c4a44a — warm gold for primary accent (repair lines)
- **Moss Green:** #5a8a4a — muted green for secondary accent
- **Rust Warm:** #8a5a3a — warm rust for tertiary accent
- **Aged White:** #e0dcd4 — warm off-white for primary text
- **Patina Gray:** #6a6a68 — warm gray for secondary text
- **Crack Border:** rgba(196,164,74,0.1) — gold-tinted border for kintsugi cracks

## Imagery and Motifs
**Duotone-Photo Aged Documentation:** Wiki imagery processed as duotone — images filtered through two-tone mapping (Void Black shadows, Kintsugi Gold highlights) creating the aged-photograph quality of historical documentation viewed through time's golden filter.

**Blur-Focus Imperfect Clarity:** Content sections with selective focus — some elements slightly blurred (filter: blur(1px)) while focal content is sharp, creating the wabi-sabi quality of knowledge that is partially clear and partially obscured, accepting incomplete understanding.

**Floating-Elements Suspended Fragments:** Decorative elements with gentle floating animation — transform: translateY oscillation (3px amplitude, 7s cycle) creating the suspended quality of knowledge fragments drifting through the wiki's imperfect space.

**Kintsugi Crack Lines:** Decorative golden lines between content blocks — SVG irregular paths (1px stroke, Kintsugi Gold at 0.08 opacity) suggesting the repaired cracks of kintsugi pottery where imperfection is filled with gold.

**Wabi-Sabi Surface Treatment:** Card backgrounds with subtle aged texture — background with fine irregular noise at 0.02 opacity and slight warm-color variation creating the used-surface quality of materials that have been handled by many researchers.

## Prompts for Implementation
Build the page as a wabi-sabi Xanadu wiki platform. Broken grid: .broken-grid { display: grid; grid-template-columns: repeat(12, 1fr); gap: 32px; max-width: 1080px; margin: 0 auto; } .offset-left { grid-column: 1 / 6; transform: translateX(-4px); } .offset-right { grid-column: 6 / 13; transform: translateX(8px); }

Blur focus: .partial-blur { filter: blur(1px); opacity: 0.85; } .focused { filter: blur(0); opacity: 1; }

Kintsugi crack: .kintsugi-line { height: 1px; background: linear-gradient(90deg, transparent, rgba(196,164,74,0.1), rgba(196,164,74,0.06), transparent); margin: 48px 0; }

AVOID: Standard wiki platforms, corporate knowledge bases, and clean encyclopedia interfaces. Let wabi-sabi imperfect beauty and authoritative certainty create a Xanadu wiki where incomplete knowledge is celebrated with the golden-crack beauty of kintsugi repair.

## Uniqueness Notes
1. **Wabi-sabi for Xanadu wiki:** Imperfection aesthetics celebrate a wiki's perpetual incompleteness as beautiful rather than deficient.
2. **Broken-grid as aged structure:** Intentionally disrupted layout creates the earthquake-shifted quality of knowledge architecture showing beautiful wear.
3. **Authoritative tone as certain voice in imperfect vessel:** Definitive language grounds visual imperfection with scholarly certainty.
4. **Floating-elements as knowledge fragments:** Suspended motifs create the drifting quality of wiki content in perpetual revision.
5. **Kintsugi cracks as golden repair:** Gold-filled line decorations celebrate the wiki's joins and connections as beautiful seams.

**Seed/Style:** aesthetic: wabi-sabi, layout: broken-grid, typography: geometric-sans, palette: high-contrast, patterns: blur-focus, imagery: duotone-photo, motifs: floating-elements, tone: authoritative

**Avoided Overused Patterns:** corporate aesthetic, parallax patterns, asymmetric layout, mono typography, warm palette, friendly tone, minimal imagery. This design uses wabi-sabi aesthetic, broken-grid layout, geometric-sans typography, high-contrast palette, blur-focus patterns, duotone-photo imagery, and authoritative tone.
<!-- DESIGN STAMP
  timestamp: 2026-03-19T07:12:24
  domain: xanadu.wiki
  seed: unspecified
  aesthetic: xanadu.wiki channels a wabi-sabi aesthetic — the beauty of imperfection, the wis...
  content_hash: 7ea48b24ccf9
-->
