# Design Language for blockchain.day

## Aesthetics and Tone
blockchain.day is a pastoral love letter to decentralization -- as if the blockchain were not invented in a cypherpunk mailing list but cultivated in a tropical garden, its distributed nodes growing like mangrove roots spreading through warm tidal waters. The hand-drawn aesthetic rejects the sleek futurism typically associated with blockchain in favor of something warmer and more human: every diagram is sketched in what looks like burnt-orange ink on creamy paper, every icon is imperfectly drawn with visible wobble in the strokes, and every data structure is visualized as a living, growing organism rather than a cold technical schematic. The ".day" suffix evokes a specific celebratory moment -- a blockchain holiday illustrated in a hand-drawn diary. The tone is pastoral-romantic: wonder at the elegance of distributed consensus rendered with the loving imprecision of field sketches.

## Layout Motifs and Structure
The layout follows an **f-pattern** reading flow -- the natural scanning pattern of left-to-right readers, where the eye traces across the top, then down the left side, occasionally scanning right for points of interest. This familiar, comfortable pattern suits the hand-drawn aesthetic's emphasis on approachability.

**Primary structure:**
- **Opening viewport (100vh):** A sketched tropical scene fills the background -- hand-drawn palm fronds, mangrove roots, and tropical fish, all rendered in burnt-orange line art on a warm cream background. The "blockchain.day" logotype sits in the upper-left (f-pattern primary scan zone), rendered in a retro-display typeface that looks like vintage stamp lettering. Below and slightly right, a hand-drawn blockchain diagram shows linked blocks as seed pods connected by root-like lines.
- **Content flow (f-pattern):** A strong left-aligned content column (60% viewport width on desktop) contains the primary reading material. The left edge is reinforced by a running vine illustration (hand-drawn, burnt-orange) that grows down the margin as the user scrolls. Content blocks are separated by small hand-drawn divider illustrations: tropical fish, shells, leaf clusters.
- **Right-side discovery zone:** The remaining 35% right column contains supporting elements that reward horizontal scanning: glassmorphic info cards with frosted glass appearance, each containing a hand-drawn diagram and brief explanation. These cards "float" at irregular vertical intervals, encouraging the eye to scan right.
- **Bottom terminus:** The page concludes with a full-width hand-drawn panorama of a tropical reef, with blockchain nodes embedded as glowing pearls within oyster shells scattered along the reef floor.

## Typography and Palette
**Fonts:**
- **Display/Headlines:** "Righteous" (Google Fonts) -- a retro-display face with round, bubbly letterforms and a distinctly vintage-poster character. Weight 400 (only weight), size clamp(32px, 5.5vw, 80px). Its warm, slightly playful personality perfectly bridges the hand-drawn aesthetic with the celebratory "day" theme. Text-transform: none (mixed case for approachability).
- **Body text:** "Bitter" (Google Fonts) -- a slab-serif designed for comfortable screen reading, with sturdy letter shapes that have a hand-crafted quality echoing the overall aesthetic. Weight 400 for body, 700 for emphasis. Size 17px, line-height 1.75. Its slightly condensed proportions work well in the f-pattern's left column.
- **Diagram labels/Technical terms:** "Caveat" (Google Fonts) -- a handwriting font that looks like hasty notebook annotations, used for labeling hand-drawn diagrams and technical blockchain terms. Weight 400, size 15px. Adds authentic hand-drawn quality to technical content.

**Palette:**
- **Warm Cream:** #FDF5E6 -- primary background, the color of aged sketchbook paper
- **Burnt Sienna:** #C45B28 -- primary illustration and heading color, the signature "burnt-orange" ink
- **Tropical Teal:** #20876A -- secondary accent for glassmorphic card borders and highlighted terms
- **Deep Cocoa:** #3B2413 -- body text color, rich and warm
- **Reef Coral:** #E8826A -- tertiary accent for decorative fish illustrations and hover states
- **Frosted Glass:** rgba(255, 253, 246, 0.72) -- glassmorphic card backgrounds with backdrop-filter: blur(16px)
- **Pearl Glow:** #FFF0D4 -- subtle warm highlight for active/focus states

## Imagery and Motifs
**Core visual motifs:**
- **Hand-drawn blockchain diagrams:** Every technical diagram is rendered as if sketched by hand in burnt-orange ink. Block chains become seed pods connected by rootlike lines; hash trees become actual trees with labeled branches; network topologies become mangrove root systems viewed from above. Line weight varies intentionally (1.5px to 3px) with slight irregularities achieved via SVG path commands with deliberately imprecise control points.
- **Tropical fish as data packets:** Small hand-drawn tropical fish illustrations swim between blockchain nodes in diagrams, serving as a visual metaphor for data moving through the network. Each fish species represents a different data type. Fish are rendered in Burnt Sienna outlines with Reef Coral accent fills.
- **Glassmorphic info cards:** Supporting content sits on frosted-glass cards that float over the hand-drawn background. Each card has: background rgba(255,253,246,0.72), backdrop-filter: blur(16px), border: 1px solid rgba(196,91,40,0.2), border-radius: 16px. The glassmorphic treatment creates a modern layer hovering over the rustic hand-drawn world.
- **Tilt-3d hover effect:** Glassmorphic cards respond to hover with a subtle 3D tilt -- the card rotates slightly toward the cursor position (max 5 degrees on each axis), calculated from cursor position relative to card center. Combined with a subtle shadow shift, this creates a tangible, physical-card feeling.
- **Growing vine scroll indicator:** A hand-drawn vine illustration along the left margin literally "grows" as the user scrolls -- new leaves and tendrils appear via SVG path-draw animation triggered by scroll position. By page bottom, the vine is fully grown with flowers blooming.

## Prompts for Implementation
**Full-screen narrative experience:** The site should feel like paging through an illustrated field journal about blockchain in a tropical setting. The hand-drawn quality is paramount -- all SVG illustrations should use slightly wobbly paths (add small random offsets to control points) rather than mathematically perfect curves.

**Opening sketch-in animation:**
- Frame 0-600ms: Warm Cream background. A pencil-scratch sound effect could play (optional, no autoplay).
- Frame 600-2000ms: The tropical background scene draws itself via stroke-dashoffset animation. Palm fronds first (400ms each, starting from trunk outward), then mangrove roots (extending downward), then fish swimming into frame (translateX animation from off-screen).
- Frame 2000-2800ms: The "blockchain.day" logotype stamps in with a slight scale-bounce (1.1 to 1.0) and a rotation settle (-2deg to 0deg), as if pressed by a rubber stamp.
- Frame 2800-3400ms: The blockchain seed-pod diagram draws itself, pods appearing first, then connecting root-lines growing between them.

**F-pattern scroll experience:** The left content column scrolls normally. The right-side glassmorphic cards enter with a subtle tilt (rotateY: -5deg to 0deg, opacity 0 to 1) triggered by IntersectionObserver at threshold 0.3. The growing vine in the left margin updates its stroke-dashoffset based on a CSS custom property --scroll-progress set via JS scroll listener.

**Tilt-3d card interaction:** Attach mousemove listeners to each glassmorphic card. Calculate cursor position relative to card center, map to rotation values (maxRotation * (cursorOffset / halfCardDimension)), and apply via transform: perspective(800px) rotateX(Ydeg) rotateY(Xdeg). Use requestAnimationFrame for smooth updates. On mouseleave, spring-animate back to neutral (transition: transform 400ms cubic-bezier(0.34, 1.56, 0.64, 1)).

**AVOID:** CTA-heavy layouts, pricing blocks, stat-grids, dark-mode crypto dashboards, neon color schemes. This is pastoral and warm, not clinical or futuristic.

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

1. **Hand-drawn blockchain diagrams as organic growth systems:** Reinterpreting blockchain data structures as botanical/tropical organisms (seed pods for blocks, root systems for chains, mangrove networks for distributed topologies) is a unique visualization approach that no other design attempts.

2. **Growing vine scroll progress indicator:** The margin vine that literally grows with scroll progress -- adding leaves, tendrils, and flowers as the user reads -- is a distinctive navigation metaphor that doubles as a delightful illustration.

3. **Glassmorphic cards floating over hand-drawn backgrounds:** The contrast between modern frosted-glass UI elements and rustic hand-drawn illustration creates a distinctive layered visual language -- the digital present hovering over the analog past.

4. **Tropical fish as data packet metaphors:** Using different species of hand-drawn fish to represent different data types moving through blockchain visualizations adds narrative charm and educational clarity in a way no other design explores.

**Chosen seed/style:** hand-drawn aesthetic, f-pattern layout, retro-display typography, burnt-orange palette, tilt-3d patterns, glassmorphic-cards imagery, tropical-fish motifs, pastoral-romantic tone.

**Avoided overused patterns:** Avoided centered layout (93%), card-grid (80%), photography (73%), gradient palette (96%), parallax (90%), scroll-triggered (83%), cursor-follow (76%), mono typography (90%), mysterious-moody tone (73%). Instead used f-pattern layout (3% -- very underused), tilt-3d patterns (10%), glassmorphic-cards imagery (3%), retro-display typography (3%), tropical-fish motifs (never used), and pastoral-romantic tone (3%).
<!-- DESIGN STAMP
  timestamp: 2026-03-21T11:26:47
  domain: blockchain.day
  seed: pods for blocks, root systems for chains, mangrove networks for distributed topologies
  aesthetic: blockchain.day is a pastoral love letter to decentralization -- as if the blockc...
  content_hash: c310db26743f
-->
