# Design Language for xity.quest

## Aesthetics and Tone
xity.quest should feel like discovering a pocket-sized model city in the back room of a 1960s natural history museum: candy-colored, optimistic, handmade, and quietly rooted in soil. The mood is **mid-century civic wonder** rather than futuristic smart-city gloss. Imagine Charles and Ray Eames making a quest map for a neighborhood built by bees, seed pods, sidewalk chalk, and municipal signage. The site is an invitation to wander through an imaginary “xity” whose streets are hexagons, whose landmarks are rounded vector sculptures, and whose civic rituals are playful but grounded.

The tone is **grounded-earthy** with flashes of candy brightness: cheerful orange transit arrows, berry-pink plaza markers, lime-green garden roofs, and chocolate-brown contour lines. It should avoid corporate SaaS polish, tech-dashboard intimidation, and generic fantasy-game darkness. The visual world is tactile, analog, sunlit, and slightly educational, as if every section is a diorama label for a neighborhood that exists halfway between a quest board and a municipal planning model.

## Layout Motifs and Structure
Use a **hexagonal-honeycomb** spatial system as the organizing principle. The page should not read as a centered stack or a card grid; it should feel like a top-down city map made from interlocking hex tiles. Each full-screen chapter is a district in the xity, and each district is composed of oversized clipped hexagons, partial edge-hexes, and organic blob clearings that interrupt the geometric order.

Structure the experience as a full-screen narrative journey with 5-6 “districts”:

1. **Arrival Hive:** A 100vh opening district with the domain name nestled inside a large central hex plaza, surrounded by half-visible neighboring hexes that hint at streets beyond the viewport. The title should sit slightly off-axis, never perfectly centered, with a hand-placed model-city quality.
2. **Map of Motives:** A honeycomb field where each hex is a small illustrated clue: a keyhole fountain, a seed-library kiosk, a tiny bus shaped like a beetle, a mailbox with a flag, a moonlit crosswalk. The layout may use CSS `clip-path: polygon(...)` for real hex silhouettes.
3. **The Soft Grid Break:** Organic blob parks push between hex streets, bending the city plan. Content ribbons follow these blob edges with curved dotted paths rather than straight horizontal dividers.
4. **Counter-Clock District:** A chapter where small animated counters count city rituals rather than metrics: steps to the plaza, lanterns lit, doors knocked, routes remembered. These counters should be decorative narrative instruments, not a stat grid.
5. **Night Market Quest:** A darker but still candy-bright scene using overlapping hex lanterns, marquee dots, and mid-century shop-sign shapes.
6. **Return to Ground:** A closing full-screen map that zooms back to show the xity as a honeycomb seed pod, with the domain name stamped like a museum accession label.

The composition should privilege diagonals at 30° and 60°, offset columns, and edge-cropped forms. Navigation, if present, should appear as small map pins along one side rather than a conventional top bar.

## Typography and Palette
Use Google Fonts with a warm rounded personality and mid-century sign-painting charm:

- **Display:** "Baloo 2" (Google Fonts), weights 600-800. Use for the xity.quest wordmark, district names, and large map labels. Its rounded bowls feel civic, playful, and approachable.
- **Body:** "Nunito" (Google Fonts), weights 400-700. Use for short narrative copy, labels, and explanatory fragments; keep paragraphs compact and map-caption-like.
- **Accent / Label:** "Fraunces" (Google Fonts), weight 600 or 700, optical size if available. Use sparingly for museum-label captions, stamped coordinates, and tiny civic proclamations.

Palette: candy-bright colors anchored by earthy grounding tones.

- **Cream Paper:** `#FFF3D6` — warm museum-card background.
- **Clay Brown:** `#5A3A24` — primary text, contour lines, grounding strokes.
- **Persimmon Orange:** `#FF7A3D` — transit arrows, highlighted hex edges.
- **Strawberry Pink:** `#FF4F8B` — quest markers, lantern glow, playful accents.
- **Lime Sprout:** `#A7E848` — garden roofs, success glints, seed motifs.
- **Pool Blue:** `#3EC7D3` — waterways, cool shadow planes, nighttime signage.
- **Honey Yellow:** `#FFD447` — plaza centers, counters, path dots.
- **Cocoa Night:** `#2B1E18` — night-market backdrop and deep contrast moments.

Use flat color fields rather than photographic gradients. If gradients appear, they should be subtle screen-print overlaps between adjacent candy colors, never glossy corporate washes.

## Imagery and Motifs
Imagery should be entirely **vector-art** and CSS-shaped illustration: no photography, no stock hero images, no realistic city skylines. The world is built from bold shapes, thick strokes, clipped hexagons, rounded rectangles, and bean-like **organic blobs**.

Primary motifs:

- **Honeycomb Streets:** Repeating hex outlines that behave like neighborhoods, transit cells, quest rooms, and garden plots all at once.
- **Organic Blob Parks:** Irregular green and pink blobs that overflow the hex plan, suggesting that nature is gently reclaiming the city grid.
- **Mid-Century Civic Icons:** Simplified vector benches, kiosks, library cards, bus stops, flagpoles, arrows, sunbursts, fountain bowls, mailboxes, and map pins.
- **Quest Breadcrumbs:** Dotted paths, numbered coordinate tabs, tiny key symbols, and stamped labels such as “district 03,” “turn left at the seed fountain,” or “listen for the orange bell.”
- **Screen-Print Texture:** Use CSS radial dots, subtle misregistration shadows, and overprinted color offsets to evoke risograph posters and museum exhibit panels.
- **Counter-Animated Rituals:** Small odometer-like numerals flip or roll to mark narrative actions. Treat them like kinetic signage on a city model, not analytics.

Illustrations can be made with inline SVG, CSS pseudo-elements, and layered divs. Favor chunky silhouettes, soft corners, and visible outline strokes in `#5A3A24`.

## Prompts for Implementation
Build the site as a single immersive, full-screen narrative experience. Keep the user moving through districts rather than selling them on a product. Avoid CTA-heavy layouts, pricing blocks, testimonials, stat grids, and generic feature cards.

Implementation guidance:

- Use `section` elements that each occupy `min-height: 100vh`, with each section representing a district of the xity.
- Construct honeycomb fields using CSS Grid with offset rows, custom properties, and `clip-path: polygon(25% 6%, 75% 6%, 100% 50%, 75% 94%, 25% 94%, 0 50%)`.
- Let some hexes be oversized, rotated by tiny amounts, cropped by the viewport, or filled with vector mini-scenes.
- Use organic blob overlays with large `border-radius` values and `clip-path` curves to disrupt the hex order.
- Add counter-animation with vanilla JavaScript using `requestAnimationFrame`: counters should count poetic variables such as “lanterns found,” “alleys softened,” “maps folded,” and “bells answered.” Do not arrange them in a conventional four-column metrics row; embed them into signboards, shop windows, and transit tokens.
- Animate in **counter-motion**: as the page scrolls downward, selected hex layers drift diagonally upward-left while blob parks drift downward-right. Keep movement playful and map-like rather than cinematic parallax spectacle.
- Create a tactile poster effect with repeating radial-dot backgrounds, 2px offset color shadows, and occasional color misregistration on icons.
- Write copy as short explorer fragments, museum labels, and hand-drawn map instructions rather than marketing prose.
- Include a final “map fold” moment where the honeycomb compresses visually into a seed-pod shape or badge around `xity.quest`.

## Uniqueness Notes
- Uses a true **hexagonal-honeycomb** city-map structure, intentionally avoiding the batch’s overused card-grid and centered layouts.
- Rejects the dominant corporate, photography-led, warm-gradient, mono-type style in favor of vector-art, playful-rounded type, flat candy colors, and mid-century civic illustration.
- Treats counters as narrative signage and quest rituals, not analytics, avoiding conventional stat-grid usage while still honoring the planned counter-animate pattern.
- Combines hard hex geometry with organic blob parks, creating tension between planned city and living ground.
- Builds a domain-specific world around “xity” as an imaginary walkable quest-city rather than a generic landing page.
- Chosen seed/style: aesthetic: mid-century, layout: hexagonal-honeycomb, typography: playful-rounded, palette: candy-bright, patterns: counter-animate, imagery: vector-art, motifs: organic-blobs, tone: grounded-earthy.
- Frequency analysis patterns intentionally avoided: corporate aesthetic, photography imagery, minimal imagery, card-grid layout, centered layout, warm/gradient palette dominance, parallax-heavy motion, scroll-triggered/stagger defaults, mono typography, and authoritative tone.
<!-- DESIGN STAMP
  timestamp: 2026-05-09T14:03:32
  domain: xity.quest
  seed: in favor of vector-art, playful-rounded type, flat candy colors, and mid-century civic illustration
  aesthetic: xity.quest should feel like discovering a pocket-sized model city in the back ro...
  content_hash: f8dfce5405af
-->
