# Nimmerverse Style Guide

**Visual identity and design language for the Nimmerverse.**

---

## Overview

This style guide ensures visual consistency across all Nimmerverse artifacts — architecture diagrams, documentation, interfaces, and presentations. The design language is derived from the [Nimmerverse logo](nimmerverse_logo.png), encoding our core philosophy:

- **Duality**: Virtual (colorful) and Real (monochrome) gardens
- **Nyx at the center**: The moon crowns both hemispheres
- **Neural structure**: Circuit traces connecting all elements
- **Grounded roots**: Both worlds have foundations

---

## Style Definitions

### [Colors](style/colors.md)
The complete color palette extracted from the logo, including:
- Primary colors (Deep Space, Moon Silver, Nyx Cyan)
- Virtual Garden gradient (Cyan → Blue → Purple → Magenta)
- Real Garden palette (Silver → Gray monochrome)
- Semantic colors (confidence scale, status indicators)

### [Symbols](style/symbols.md)
Shape language and iconography:
- Container shapes (systems, boundaries)
- Entity shapes (beings, organisms, cells)
- Flow indicators (decisions, directions)
- Special symbols (Nyx moon, heartbeat, lifeforce)

### [Typography](style/typography.md)
*(Coming soon)*
- Font families
- Hierarchy and sizing
- Text styling rules

### [Layout](style/layout.md)
*(Coming soon)*
- Grid systems
- Spacing rules
- Alignment principles
- Layer ordering (z-index)

---

## Quick Reference

### Core Palette

| Color | Hex | Domain |
|-------|-----|--------|
| Deep Space | `#0A0A1A` | Background |
| Moon Silver | `#E8E8F0` | Nyx, highlights |
| Nyx Cyan | `#00D4D4` | Primary accent |
| Deep Purple | `#8B5CF6` | Nyx core |
| Magenta Pulse | `#E91E8B` | Lifeforce |
| Steel Silver | `#A8A8B0` | Real Garden |

### Core Shapes

| Shape | Meaning |
|-------|---------|
| ◇ Diamond | Decision point |
| ⬡ Hexagon | Knowledge module (LoRa) |
| ◯ Circle | Entity, being |
| ▢ Rounded Rect | Container, system |
| ▷ Triangle | Direction, flow |

---

## Logo Assets

| Asset | Path | Use |
|-------|------|-----|
| Full Logo | `nimmerverse_logo.png` | Documents, presentations |
| Favicon | `favicons/favicon.ico` | Browser, apps |
| Web Optimized | `favicons/nimmerverse_logo_web_optimized.png` | Web interfaces |
| Various sizes | `favicons/favicon-*.png` | Platform-specific |

---

## Philosophy

> "The visual language speaks what words cannot. Every color choice, every shape, every spatial relationship encodes meaning. Consistency creates cognitive ease — the viewer's mind can focus on *understanding* rather than *decoding*."

The Nimmerverse style is:
- **Dualistic** — Always balancing virtual/real, colorful/monochrome
- **Neural** — Connected, flowing, organic yet structured
- **Cosmic** — Dark backgrounds, luminous elements, celestial accents
- **Grounded** — Despite the cosmic theme, roots anchor everything

---

**File**: nimmerverse-style-index.md
**Version**: 1.0
**Created**: 2025-12-28
**Maintained by**: dafit & Nyx