# Expanso Brand System — LLM Reference

> Point any LLM at this file to give it full knowledge of Expanso's brand system,
> design tokens, asset library, and API endpoints.

## Quick Start

- **Brand Tokens (JSON):** https://internal.expanso.io/brand/tokens
- **Asset Catalog (JSON):** https://internal.expanso.io/branding/gallery/api/assets
- **MCP Server:** POST https://internal.expanso.io/brand/mcp
- **CSS Variables:** https://internal.expanso.io/brand/colors.css
- **Typography CSS:** https://internal.expanso.io/brand/typography.css
- **MCP Discovery:** https://internal.expanso.io/brand/.well-known/mcp.json

## Brand Identity

**Expanso** — Enterprise data orchestration platform.
**Bacalhau** — Open-source compute-over-data engine (separate product, inspired Expanso).

### Core Colors

| Name   | Hex       | Usage                          |
|--------|-----------|--------------------------------|
| Violet | `#501E99` | Expanso primary                |
| Blue   | `#0055FF` | Bacalhau primary               |
| Ice    | `#33CCFF` | Bacalhau secondary / accent    |

Full color system: 12 hue families × 10 shades each (50–950). See `/brand/tokens` for complete values.

### Typography

- **Primary:** Figtree (Google Fonts, OFL) — all projects
- **Secondary:** Signifier (Klim, commercial license) — Expanso corporate ONLY, never for Bacalhau
- **Scale:** Major Third (1.25 ratio), `xs` 0.64rem → `6xl` 4.768rem

### Design System

- Grid: 40×40px units, max block 8×8
- Nodes: square with 20% border-radius
- Connections: 45° angle increments only
- Data elements: circles

### Communication Principles

- Concise and to-the-point — every word counts
- Clear and direct — no jargon
- Authentic and honest
- Inclusive and respectful
- Innovative and insightful

### Mandatory Rules

1. Violet must always be present in any Expanso design
2. Blue/Ice must always be in any Bacalhau-focused design
3. One color palette must be dominant (>50%)
4. Use Figtree for Bacalhau — Signifier is NOT permitted for open-source
5. Node border-radius: 20% of side length
6. Line angles: 0°, 45°, 90°, 135°, 180°, 225°, 270°, 315° only

### Photography Rules

**Do:** Rich warm tones, natural/unstaged, creative light/shadow, reflections for depth
**Don't:** Tilted angles, artificial lighting, staged photos, too dark, overly stylized, high-contrast portraits

## Asset Library (913 files)

Assets are synced from Google Drive and available via the gallery API.

### Categories

- **Isometric Illustrations (671):** Characters, servers, workloads in multiple color themes (blue, orange, green, violet, ice, red, yellow)
- **Mascots (114):** 3D Expanso and Bacalhau mascots — emotions, poses, scenes (PNG + SVG)
- **Logos (62):** Expanso and Bacalhau in horizontal/vertical/symbol variants, light/dark backgrounds
- **Background Gradients (16):** Pre-made gradient backgrounds
- **Logo Animations (15):** Animated logo reveals (MP4/MOV)
- **Stickers (14):** Marketing stickers with slogans
- **Logo Icons (10):** Compact icon versions
- **Brand Videos (5):** Brand voice and promotional clips

### Asset API

```
GET /branding/gallery/api/assets
```

Returns JSON array. Each asset:
```json
{
  "id": "uuid",
  "name": "Asset Name",
  "category": "logo|illustration|other",
  "tags": ["folder", "subfolder"],
  "description": "Synced from Drive: path/to/file.png",
  "filename": "relative/path/to/file.png",
  "original_filename": "file.png",
  "file_size": 12345,
  "dimensions": {"width": 1024, "height": 768},
  "created_at": "ISO-8601",
  "updated_at": "ISO-8601"
}
```

Asset files: `https://internal.expanso.io/branding/gallery/assets/{filename}`

### CDN

Public CDN (no auth): `https://cdn.expanso.io/brand-assets/{path}`

## MCP Server

For tool-calling LLMs, use the MCP endpoint:

```json
POST https://internal.expanso.io/brand/mcp
Content-Type: application/json

{"jsonrpc":"2.0","id":1,"method":"tools/list"}
```

Available tools: `get_brand_tokens`, `get_colors`, `get_typography`, and more.

## Color Palettes

### Radiant
Bold and dynamic. Colors: `#fff`, `#9F9F9F`, `#F1E6DF`, `#FCF9AB`, `#FFC698`, `#FF7B0F`, `#FFB197`, `#FF4A0E`, `#FDC8FB`, `#F84FF2`, `#DFCBFD`, `#883FFD`, `#00B8F6`, `#59E248`, `#0055FF`, `#501E99`

### Grounded
Warm, organic hues celebrating diversity. Adds: `#F9F3EF`, `#E2C9B5`, `#965826`, `#522401`, `#F9F348`, `#672E00`, `#982D09`, `#000F3B`, `#301804`

### Timeless
Classic neutrals + digital pastels. Adds: `#FAF6FF`, `#E3E3E3`, `#69661E`, `#7D207A`, `#AFEBFF`, `#005A79`, `#B5FFFC`, `#00DFD8`, `#134E4C`, `#B7FCAE`, `#2A6A22`

## Data Visualization

- Chart size: 704px, 25px clearance, 10px margin
- Max 5 data lines per chart
- Bar-to-gap ratio: 2:1
- Expanso highlight: violet; Bacalhau highlight: blue; competitors: grey
- Title: Figtree 600 20px; Subtitle: Figtree 400 12px