# Design Language for chloe.cx

## Aesthetics and Tone
Chloe.cx is a game engine -- but presented through the unexpected lens of **light-academia**: the romanticism of sunlit libraries, amber-toned study halls, and the intellectual pursuit of craft. Where most game engines present themselves with dark-mode neon dashboards and aggressive tech aesthetics, Chloe takes the opposite approach -- it frames game development as a scholarly, creative discipline akin to architecture or classical composition. The visual identity evokes a late-afternoon atelier where warm light pours through tall windows onto workbenches covered with engine documentation, shader sketches, and hand-annotated render graphs. The tone is **raw-authentic** -- no corporate polish, no startup hype. Chloe speaks like a brilliant indie developer explaining their engine over coffee in a university common room: technically precise but personally warm, confident without being boastful.

## Layout Motifs and Structure
The layout employs a **HUD-overlay** composition -- information panels float over a persistent background scene, mimicking a game engine's own viewport-plus-panels interface, but rendered in light-academia warmth instead of dark IDE chrome.

**Primary structure:**
- **Viewport background (100vw x 100vh, fixed):** A warm, softly animated gradient (sunset tones: #F5E6D3 to #E8C4A0 to #D4956B) that shifts slowly over 30s (CSS animation: hue-shift keyframes). This represents the "scene" -- the creative canvas.
- **HUD panels (floating overlays):** Content is presented in semi-transparent floating panels positioned at strategic screen regions. Each panel has a warm frosted-glass effect (backdrop-filter: blur(8px), background: rgba(255, 248, 240, 0.88)), thin borders (1px solid rgba(180, 140, 100, 0.3)), and subtle box-shadows (0 4px 24px rgba(120, 80, 40, 0.1)).
- **Top-left panel (logo + tagline):** "Chloe" in an elegant sans-grotesk face, with ".cx" in a lighter weight. Below: "A game engine for the thoughtful developer."
- **Center-right panel (main content, 560px max-width):** Scrollable content area containing engine features, philosophy, and technical highlights. This panel has a subtle crystalline border decoration -- small diamond shapes at the corners rendered as rotated squares (CSS transform: rotate(45deg)).
- **Bottom panel (full-width, 80px):** A thin bar containing navigation links, version info, and a GitHub link. Styled as a "status bar" in the HUD metaphor.
- **Floating accent panels (2-3 small panels, 200px wide):** Positioned at screen edges, containing contextual information like "Latest commit: 2 hours ago" or "Renderer: Vulkan 1.3" -- these appear with bounce-enter animations as the user scrolls.

## Typography and Palette
**Fonts:**
- **Headlines:** "Space Grotesk" (Google Fonts) -- a sans-grotesk with distinctive geometric character and subtle quirkiness in its letterforms (note the single-story 'a' and the angular 'G'). Used at weight 700 for main headings, 500 for subheadings. Size: clamp(28px, 4vw, 52px). Letter-spacing: -0.01em. Its precise-yet-warm character perfectly bridges the technical (game engine) and the academic (light-academia).
- **Body text:** "Libre Baskerville" (Google Fonts) -- a refined serif that brings the academic gravitas of a well-typeset textbook. Weight 400 for body, 700 for emphasis. Line-height: 1.75. Size: clamp(16px, 1.6vw, 18px). The serif-sans pairing (Baskerville body under Grotesk headings) creates a scholarly-technical tension that defines the brand.
- **Code/Technical:** "JetBrains Mono" (Google Fonts) -- used for code snippets, API references, and version numbers. Weight 400. Size: 14px. Rendered with a warm background tint (rgba(212, 149, 107, 0.12)) instead of the typical cold gray.

**Palette:**
- **Parchment Light** #FFF8F0 -- Primary text panel backgrounds, the lightest surface
- **Amber Glow** #E8C4A0 -- Secondary backgrounds, warm mid-tone for depth
- **Sunset Terracotta** #D4956B -- Primary accent, used for links, active states, and decorative elements
- **Deep Umber** #5C3A1E -- Primary text color, warm dark brown instead of black
- **Crystalline Rose** #C47D8A -- Secondary accent for hover states and highlight markers
- **Warm Charcoal** #3D2E1F -- Used for code blocks and the darkest typographic elements
- **Golden Hour** #F0C040 -- Tertiary accent for badges, status indicators, and small highlights
- **Faded Sage** #A8B8A0 -- Subtle tertiary for metadata, timestamps, and secondary information

## Imagery and Motifs
**Core visual motifs:**
- **Crystalline decorations:** Small diamond/crystal shapes (CSS: 12px squares rotated 45deg with 1px borders in Sunset Terracotta) placed at panel corners, section dividers, and as list markers. These reference both light-academia's fondness for elegant ornament and the crystalline geometric precision of a well-architected engine.
- **Mixed-media collage panels:** Feature presentations combine hand-sketched-style SVG diagrams (render pipeline flowcharts with organic, slightly imperfect line strokes -- stroke-dasharray for a hand-drawn feel) overlaid on soft photographic textures (warm bokeh, amber-toned abstract imagery). This mixed-media approach reflects the engine's dual nature: artistic + technical.
- **Sunlight ray overlays:** Diagonal gradient bands (linear-gradient at 35deg, Golden Hour at 5% opacity to transparent) sweep across panels, simulating afternoon light falling across a desk surface. Animated subtly with CSS (translateX shift over 20s).
- **Marginalia annotations:** Small, handwritten-style notes appear in the margins of content panels -- styled with "Caveat" (Google Fonts) at 14px in Faded Sage. These contain parenthetical developer commentary: "(yes, it's that fast)", "(we rewrote this three times)", adding to the raw-authentic tone.
- **Crystalline grid pattern:** A subtle background pattern of thin diamond-grid lines (SVG pattern: diagonal crosshatch at 60px intervals, 0.5px stroke, Amber Glow at 15% opacity) appears behind the floating panels on the viewport background.

## Prompts for Implementation
**Full-screen narrative opening:** The page loads with the warm gradient viewport fully visible. After 300ms, the top-left logo panel slides in from the left with a **bounce-enter** animation (translateX: -100%→0 with cubic-bezier(0.34, 1.56, 0.64, 1) over 600ms). At 500ms, the center-right content panel drops from above (translateY: -40px→0, bounce easing, 500ms). At 800ms, small floating accent panels pop in from the edges with scale(0.8)→scale(1) bounce animations staggered by 150ms each. The overall effect is a game engine interface "booting up" -- panels appearing one by one as if a UI system is initializing.

**HUD panel depth:** Panels exist at different visual depths. The main content panel has the strongest backdrop blur (12px) and highest opacity. Accent panels have lighter blur (6px) and lower opacity (0.75). The bottom status bar has minimal blur (4px). This creates a layered-depth perception without traditional parallax.

**Interactive crystalline hover:** When hovering over feature cards within the main panel, the corner crystalline decorations rotate (transform: rotate(45deg)→rotate(225deg) over 300ms) and shift color from Sunset Terracotta to Crystalline Rose. The card itself gets a subtle warm glow (box-shadow transition: 0 0 0 transparent → 0 0 20px rgba(212, 149, 107, 0.2)).

**Storytelling structure:** The scrollable content area tells Chloe's story as a journey: "Why another engine?" → "What we believe" → "How it works" → "What's possible." Each section is separated by a full-width crystalline divider (a horizontal line of diamond shapes). Avoid CTA-heavy layouts, pricing blocks, and stat-grids. Feature presentations are narrative paragraphs with inline code snippets, not bullet-point spec sheets.

**Scroll-driven panel evolution:** As the user scrolls the main content panel, the viewport background gradient slowly shifts warmth (from afternoon to golden hour: terracotta tones intensify). Small floating panels update their content to reflect the current section context. This is achieved via Intersection Observer triggering CSS custom property changes.

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

1. **Light-academia game engine identity:** Applying warm, scholarly aesthetics to game engine presentation is a deliberate inversion of the dark-mode, neon-accented convention. The serif body text, warm browns, and parchment tones create an unprecedented identity for technical game development tools.

2. **HUD-overlay with academic warmth:** The floating panel layout references game engine viewports, but rendered in frosted-parchment instead of dark chrome. This dual-metaphor (game HUD + academic study desk) is unique to this design.

3. **Marginalia developer commentary system:** Hand-lettered margin notes in "Caveat" font, containing authentic developer asides, create a personal, zine-like quality within a technical presentation -- combining raw-authentic tone with light-academia elegance.

4. **Crystalline ornament as design system element:** Using rotated diamond shapes as a consistent decorative vocabulary (corners, dividers, list markers, hover states) creates a cohesive visual language that references both crystalline precision and academic ornamentation.

**Seed/Style:** light-academia + hud-overlay + sans-grotesk + sunset-warm + bounce-enter + mixed-media + crystalline + raw-authentic
**Avoided overused patterns:** Avoided centered layout dominance (used hud-overlay floating panels instead), avoided parallax-heavy scrolling (used panel-depth layering instead), avoided mono as primary typography (used sans-grotesk + serif pairing).
**Preferred underused elements:** Incorporated hud-overlay layout (3% frequency), bounce-enter pattern (13%), mixed-media imagery (3%), and crystalline motifs (10%).
<!-- DESIGN STAMP
  timestamp: 2026-03-21T11:19:04
  seed: unspecified
  aesthetic: Chloe.cx is a game engine -- but presented through the unexpected lens of **ligh...
  content_hash: c2d87a6bc440
-->
