# Hevium Brand Guidelines

Official visual identity specification for **Hevium** (`https://hevium.xyz`, `https://docs.hevium.xyz`, `https://mcp.hevium.xyz`, `@heviumxyz`).

## 1. Logo System

- **Horizontal Lockup (`02-horizontal-lockup/`)**: Primary brand signature combining the swept star-H symbol with the `Hevium` wordmark set in **Plus Jakarta Sans ExtraBold (800)** at `-0.04em` tracking.
- **Logomark (`01-logomark/`)**: Standalone symbol for compact spaces, favicons, avatars, and token badges.
- **Stacked Lockup (`03-stacked-lockup/`)**: Vertical emblem + wordmark lockup for square cards, pitch covers, and merchandise.
- **Wordmark (`04-wordmark/`)**: Standalone typography for Editorial Headers where the symbol already appears nearby.

### Variant Usage
- **Dark Theme (Primary)**: Gradient Mint mark (`#97FBE3 -> #1CD8B3`) + Pure White (`#FFFFFF`) wordmark on Obsidian (`#07080B`).
- **Light Theme**: High-contrast Teal-Mint mark (`#14C8A5 -> #0D9488`) + Obsidian (`#07080B`) wordmark on white or light surfaces.
- **Monochrome**: All-White (`#FFFFFF`) or All-Obsidian (`#07080B`) where single-ink printing or partner monochrome constraints apply.

## 2. Clearspace & Minimum Sizes

- Maintain clearspace equal to at least **1x the vertical height of the central crossbar** (approx. `25%` of mark width) on all four sides.
- **Minimum Logomark Width**: `24px` digital / `8mm` print.
- **Minimum Horizontal Lockup Width**: `96px` digital / `28mm` print.

## 3. Official Color Palette

| Token | Hex | RGB | Role |
|---|---|---|---|
| **Hevium Mint** | `#97FBE3` | `151, 251, 227` | Primary accent, logo highlight, active states |
| **Deep Teal** | `#1CD8B3` | `28, 216, 179` | Logo gradient end-stop, hover/depth stop |
| **Obsidian** | `#07080B` | `7, 8, 11` | Primary dark canvas background |
| **Carbon Surface** | `#0E1117` | `14, 17, 23` | Card & panel surface |
| **Pure White** | `#FFFFFF` | `255, 255, 255` | Primary dark-mode wordmark & headings |
| **Light Mint Accent (Text/Light BG)** | `#0D9488` | `13, 148, 136` | Accessible teal stop on light backgrounds |

## 4. Typography

- **Primary & Wordmark Typeface**: **Plus Jakarta Sans** (`800 ExtraBold` for wordmark, `600–700` for headings, `400–500` for body).
- **Monospace / On-Chain Data**: **JetBrains Mono** / `ui-monospace` for contract addresses, calldata, and terminal metrics.

## 5. Do's & Don'ts

- **DO** use the provided SVG or high-resolution PNG files without distortion.
- **DO** use crisp dark or light contrast lockups appropriate to your canvas.
- **DON'T** rotate, skew, stretch, outline, or apply drop shadows to the mark.
- **DON'T** place the bright `#97FBE3` mint mark directly on a stark white background without the high-contrast light lockup or obsidian backing tile.
- **DON'T** abbreviate or stylize "Hevium" in conflicting typefaces alongside the mark.
