# Design Language for mapping.day

## Aesthetics and Tone
mapping.day is a contemplative cartographic experience -- a site that treats the act of mapping as a philosophical and artistic practice rather than a utilitarian tool. The visual identity draws from the golden age of hand-drawn cartography (16th-18th century portolan charts, Cassini survey maps, Edo-period Japanese coastal maps) merged with the precision of isometric technical drawing. The result is a site that feels like unrolling a parchment scroll inside a modern drafting studio.

The tone is scholarly-intellectual yet warm-inviting, the voice of a cartographer who genuinely loves explaining how the world was measured and drawn. The site avoids cold, clinical data-viz in favor of the romance of mapping -- the human desire to render the unknown into something legible. Think "the British Ordnance Survey meets Wes Anderson's color grading."

## Layout Motifs and Structure
**Primary layout: editorial-flow with diagonal-sections and timeline-vertical elements**

The site uses a wide editorial layout (max-width 1200px) organized as a vertical scroll through the history and philosophy of mapping. The primary structural device is the "survey line" -- a thin vertical line running down the center-left of the page (at 33% width) that acts as both a timeline and a visual anchor.

**Section architecture:**

1. **The Compass Rose (viewport 1):** A full-viewport opening featuring an animated SVG compass rose that assembles itself from its component lines -- first the cardinal directions, then the ordinal, then the decorative flourishes. The site title "mapping.day" appears along the North axis in small-caps.

2. **The Survey Path (viewports 2-6):** Content flows alongside the central survey line. Each section represents a mapping tradition: Ptolemaic grids, Arabic astronomical cartography, Chinese grid-square method (Ji Li Hua Fang), Mercator projection, and satellite imaging. Sections alternate between left-aligned text with right-aligned map fragment illustrations and vice versa, creating a zigzag reading path that mirrors the triangulation method surveyors use.

3. **The Projection Theater (viewport 7-8):** An interactive horizontal-scroll section where different map projections (Mercator, Robinson, Winkel Tripel, Dymaxion) are shown side by side, each with a brief annotation. The maps are drawn as SVG outlines with animated coordinate grids.

4. **The Legend (viewport 9):** A section styled as a map legend, listing the "symbols" used throughout the site: typography, color, line weights. This is both a design key and a self-referential meditation on what legends do.

5. **The Terra Incognita (footer):** The page ends with an empty parchment field labeled "Here be dragons" in an italic serif, inviting the user to imagine what lies beyond the mapped territory.

## Typography and Palette
**Typography:**

- **Display / Section Headers:** "Playfair Display" (Google Fonts) -- an elegant transitional serif with high stroke contrast, evoking 18th-century cartographic title cartouches. Used at clamp(2rem, 5vw, 3.5rem), weight 700, with subtle letter-spacing of 0.08em. Small-caps variant used for geographic labels.

- **Body / Narrative:** "Source Serif 4" (Google Fonts) -- a reading-optimized serif that bridges old-style and transitional classification. Weight 400, line-height 1.8, 17px base. Its slightly informal character prevents the scholarly tone from becoming stiff.

- **Annotations / Technical Labels:** "IBM Plex Mono" (Google Fonts) -- a technical monospace used for coordinates, projection parameters, scale bars, and metadata. Weight 400, 13px, letter-spacing 0.03em. Always rendered in the Rust Brown accent color to distinguish from narrative text.

**Palette:**

| Role | Color | Hex |
|------|-------|-----|
| Parchment (background) | Aged cream | #f5ecd7 |
| Ink (primary text) | Sepia dark | #3d2b1f |
| Coastline (accent 1) | Teal blue | #2e7d82 |
| Elevation (accent 2) | Rust brown | #a0522d |
| Forest (accent 3) | Sage green | #6b7f52 |
| Grid lines | Light sienna | #d4b896 |
| Deep water | Navy ink | #1a3044 |
| Highlight | Gold leaf | #c8a951 |

This is an earth-tones palette with sepia-nostalgic warmth, inspired by actual historical map coloring conventions: blue for water, green for forests, brown for elevation, and gold for decorative elements. The background parchment color (#f5ecd7) gives every section the feel of a map surface.

## Imagery and Motifs
**Core Visual Motifs:**

1. **The Compass Rose:** An SVG compass rose that serves as the primary decorative element, appearing in the hero and as miniature versions marking section transitions. It's drawn with thin strokes (1-2px) and uses the teal/rust/gold accent colors for its ornamental details.

2. **Contour Lines:** CSS-generated concentric shapes (border-radius variations on nested divs) that suggest topographic contour lines. These appear as background decorations behind text sections, using the light sienna grid-line color at 0.15 opacity.

3. **Grid Overlays:** Faint coordinate grid patterns (CSS background-image: repeating-linear-gradient) overlaid on certain sections, creating the graph-paper feel of a surveyor's notebook. Grid spacing varies by section to suggest different map scales.

4. **Cartouche Frames:** Section titles are enclosed in decorative cartouche borders -- SVG-drawn ornamental frames inspired by Renaissance map title blocks. These are drawn with path-draw animation on scroll entry.

5. **Sea Monster Doodles:** Small, whimsical SVG illustrations in the style of medieval map marginalia (stylized fish, serpents, wind-blowing faces) that appear in the margins at irregular intervals. These add personality and reference the "Here be dragons" tradition.

## Prompts for Implementation
**Full-Screen Narrative Experience:**

The site opens to a parchment-colored viewport. After 300ms, the compass rose begins to draw itself at center -- SVG paths animate via stroke-dashoffset over 3 seconds, starting with the simple cross of cardinal directions, then adding the diagonal lines, then the decorative arrowheads and ornamental circles. The domain name "mapping.day" fades in along the north-pointing axis using Playfair Display SC (small caps).

A subtle CSS animation makes the parchment background "breathe" -- a very gentle scale oscillation (1.0 to 1.002, 8s cycle) combined with a paper-grain noise texture overlay that shifts position slightly, creating the feel of a physical surface.

**Scroll behavior:** The survey line (central vertical axis) is position: sticky and remains visible as the user scrolls. Content sections fade-reveal as they enter the viewport (opacity 0 to 1, translateY 30px to 0, 600ms, cubic-bezier(0.25, 0.1, 0.25, 1)). Each section's cartouche frame draws itself on entry using path-draw-svg animation.

**The Projection Theater** uses a CSS scroll-snap horizontal container. Each projection card is 80vw wide with 10vw padding on each side, creating peek-through visibility of adjacent cards. The coordinate grids within each projection card animate their line opacity from 0 to 0.3 when the card is snapped into center position.

**Interactivity:** Hovering over the compass rose in the hero causes it to rotate slowly (360deg over 20s). Hovering over sea monster marginalia causes them to wiggle (a CSS keyframe animation with slight rotation and scale bounce). The contour-line background shapes pulse gently when their parent section is in viewport.

AVOID: CTA-heavy layouts, pricing blocks, stat-grids. No marketing language. The site is a visual essay on cartography, not a mapping product page.

Bias toward full-screen narrative sections where each viewport presents one era or concept of mapping, with generous whitespace (parchment space) between elements.

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

1. **Cartographic visual vocabulary as primary design system:** No other design in the portfolio uses map-making conventions (compass roses, cartouches, contour lines, coordinate grids, sea monsters) as its UI framework. Every decorative element has a direct antecedent in historical cartography.

2. **Earth-tones palette with zero neon or gradient:** While 94% of designs use gradient palettes and 91% use warm-but-saturated palettes, mapping.day uses a deliberately muted earth-tones scheme (#f5ecd7, #3d2b1f, #2e7d82, #a0522d) that mimics actual historical map coloring.

3. **Scholarly-intellectual tone with warm accessibility:** The site occupies a rare intersection -- it's intellectually rigorous (real cartographic history, named projection systems) but avoids being cold. The sea monster marginalia and "Here be dragons" footer inject playfulness into the academic frame.

4. **Survey-line structural device:** The persistent vertical line at 33% width serves as both a timeline and a visual anchor, creating a reading rhythm unlike standard centered or full-width layouts. Content zigzags across this line, mimicking the triangulation pattern of land surveys.

5. **Self-referential legend section:** The "Legend" section is both functional (explaining the site's visual system) and thematic (exploring what legends mean in cartography). This meta-design choice is unique in the portfolio.

**Chosen seed/style:** isometric technical docs
**Avoided overused patterns:** corporate aesthetic, centered layout, gradient palette, mysterious-moody tone, counter-animate as primary animation
**Preferred underused elements:** earth-tones palette, scholarly-intellectual tone, editorial-flow layout, sepia-nostalgic warmth, elegant-serif typography
<!-- DESIGN STAMP
  timestamp: 2026-03-24T12:15:43
  domain: mapping.day
  seed: seed
  aesthetic: mapping.day is a contemplative cartographic experience -- a site that treats the...
  content_hash: fd01181a3fcd
-->
