# Brand Assets

This document helps AI agents understand the visual brand identity for consistent content creation.

## Purpose

Document brand assets and guidelines including:

- Logo usage and variations
- Color palette
- Typography
- Image and illustration style
- Design patterns

## Color Palette

Define the brand colors:

```
Primary:    #______  (e.g., #0066CC - main brand color)
Secondary:  #______  (e.g., #00CC66 - accent color)
Accent:     #______  (e.g., #CC6600 - highlight color)

Neutrals:
- Dark:     #______  (e.g., #1A1A1A - headings, body text)
- Medium:   #______  (e.g., #666666 - secondary text)
- Light:    #______  (e.g., #F5F5F5 - backgrounds)
- White:    #FFFFFF

Status:
- Success:  #______  (e.g., #22C55E)
- Warning:  #______  (e.g., #F59E0B)
- Error:    #______  (e.g., #EF4444)
- Info:     #______  (e.g., #3B82F6)
```

## Typography

Define the font families:

```
Headings:   [Font Name], [weight] (e.g., Inter, bold)
Body:       [Font Name], [weight] (e.g., Inter, regular)
Code:       [Font Name] (e.g., JetBrains Mono)
```

**Heading sizes:**
- H1: (e.g., 48px / 3rem)
- H2: (e.g., 36px / 2.25rem)
- H3: (e.g., 24px / 1.5rem)
- H4: (e.g., 20px / 1.25rem)

**Body text:** (e.g., 16px / 1rem, line-height 1.6)

## Logo Files

Reference paths to logo files:

| Variant | Path | Usage |
|---------|------|-------|
| Primary | `/public/logo.svg` | Main logo for light backgrounds |
| Dark mode | `/public/logo-dark.svg` | For dark backgrounds |
| Icon only | `/public/logo-icon.svg` | Favicon, small spaces |
| Full width | `/public/logo-full.svg` | Header, large displays |

**Logo usage guidelines:**
- Minimum clear space: (e.g., equal to the height of the logomark)
- Minimum size: (e.g., 100px width for full logo, 24px for icon)
- Don't stretch, rotate, or alter colors

## Image Style

Guidelines for imagery:

**Photography:**
- Style: (e.g., bright and modern, lifestyle-focused, professional)
- Subjects: (e.g., people using products, workspace shots, abstract)
- Avoid: (e.g., stock photo cliches, outdated imagery)

**Illustrations:**
- Style: (e.g., flat design, 3D, hand-drawn, geometric)
- Color usage: (e.g., use brand colors only, limited palette)

**Aspect ratios:**
- Hero images: (e.g., 16:9, 1920x1080 minimum)
- Blog thumbnails: (e.g., 3:2, 1200x800)
- Social sharing: (e.g., 1.91:1 for Open Graph)

## Icons

Icon style and sources:

- **Icon set**: (e.g., Lucide, Heroicons, custom)
- **Style**: (e.g., outline, solid, duotone)
- **Size**: (e.g., 24px default, 16px small, 32px large)
- **Color**: (e.g., inherit from text, or specific brand color)

## Example Completed Section

```markdown
## Color Palette

Primary:    #2563EB  (Blue - main brand color)
Secondary:  #10B981  (Green - success states, CTAs)
Accent:     #8B5CF6  (Purple - highlights)

Neutrals:
- Dark:     #111827  (Gray 900 - headings)
- Medium:   #6B7280  (Gray 500 - body text)
- Light:    #F9FAFB  (Gray 50 - backgrounds)
- White:    #FFFFFF

## Typography

Headings:   Inter, semibold (600)
Body:       Inter, regular (400)
Code:       Fira Code, regular

## Image Style

Photography: Clean, bright, professional. Real people in real workspaces.
Illustrations: Flat design with brand colors. Simple, modern, friendly.

Avoid: Dark/moody imagery, overly complex graphics, generic stock photos.
```
