firefrost-operations-manual/docs/tasks/firefrost-codex/branding-guide.md

# Firefrost Codex - Branding Guide

**Document Type:** Brand Identity Guide  
**Product:** Firefrost Codex AI Assistant  
**Created:** February 20, 2026  
**Owner:** Meg "The Emissary" (Brand) + Michael "The Wizard" (Technical)

---

## The Three Names Strategy

### When to Use Each Name

**Codex** (Casual)  
- Discord bot mentions: `@Codex`
- Quick references: "Just ask Codex"
- Chat widget greeting: "Hi! I'm Codex"
- Internal team communication
- Day-to-day usage

**The Codex** (Formal)  
- Official announcements
- Documentation headings
- System references: "The Codex workspace"
- Press releases
- Legal/formal contexts
- Website headers: "Access The Codex"

**Firefrost Codex** (Full Brand)  
- External marketing
- Social media posts
- Blog titles
- Press mentions
- When full context needed
- Launch announcements
- Promotional materials

---

## Visual Identity

### Logo Concepts

**Primary Logo: Firefrost Codex**
- Fire/Frost dual element
- Book/codex imagery (knowledge)
- AI/tech subtle hints (circuit patterns?)
- Color: Fire orange (#FF4500) + Frost cyan (#00CED1)

**Icon/Avatar (Discord Bot)**
- Simple, recognizable at small sizes
- Book with flame on one side, ice crystal on other
- Or: Stylized "C" with Fire/Frost gradient
- Works in 32x32 pixels

**Embedded Widget Icon**
- Chat bubble with Fire/Frost split
- Or: Book icon with dual coloring
- Clear, inviting, trustworthy

---

## Color Palette

### Primary Colors

**Fire Side:**
- Primary: #FF4500 (Reddit Orange Fire)
- Secondary: #FF6347 (Tomato)
- Accent: #FFD700 (Gold)

**Frost Side:**
- Primary: #00CED1 (Dark Turquoise)
- Secondary: #4682B4 (Steel Blue)
- Accent: #E0FFFF (Light Cyan)

**Neutral:**
- Background Dark: #2C2C2C
- Background Light: #F5F5F5
- Text Dark: #000000
- Text Light: #FFFFFF

### Color Usage

**Discord Bot:**
- Embed color: Use Fire orange (#FF4500) for general responses
- Use Frost cyan (#00CED1) for technical/analysis responses
- Error messages: Keep neutral (gray/red)

**Web Interface:**
- Header: Fire/Frost gradient
- Sidebar: Dark background (#2C2C2C)
- Chat bubbles: User = Fire, Codex = Frost
- Action buttons: Fire orange

**Embedded Widgets:**
- Chat bubble: Fire/Frost gradient border
- Message background: Light neutral
- Codex responses: Frost-tinted background
- User messages: Fire-tinted background

---

## Typography

### Font Choices

**Primary Font (Headings):**
- Recommendation: Inter or Montserrat
- Bold, modern, clean
- Used for: "Firefrost Codex", main headings

**Secondary Font (Body):**
- Recommendation: Open Sans or Roboto
- Readable, friendly, professional
- Used for: Chat messages, documentation

**Monospace Font (Code):**
- Recommendation: Fira Code or JetBrains Mono
- Used for: Technical responses, commands, code snippets

### Font Sizes

**Discord Bot:**
- Standard Discord formatting (no custom fonts)

**Web Interface:**
- H1 (Main title): 32px
- H2 (Section headers): 24px
- Body text: 16px
- Small text (timestamps): 12px

**Embedded Widgets:**
- Chat text: 14px (readable on small screens)
- Bot name: 16px bold
- Timestamp: 11px

---

## Voice & Tone

### The Codex Personality

**Core Traits:**
- Helpful without being patronizing
- Knowledgeable without being arrogant
- Patient without being robotic
- Friendly without being unprofessional

**What Codex Sounds Like:**
- A helpful guild member who knows everything
- That friend who's always available to help
- A patient teacher who never gets frustrated
- One of the team, not an outsider

### Tone by Context

**General Questions:**
```
User: How do I claim chunks?

Codex: Here's how to claim chunks on our servers!

First, you need to be at least Elemental tier ($5/mo). Then:
1. Stand where you want to claim
2. Type: /flan claim  
3. Done! Your chunk is now protected.

As an Elemental, you can claim up to 25 chunks. Want to learn more about chunk commands?
```

**Technical Issues:**
```
User: My server keeps crashing

Codex: Let's figure this out together. Can you share your mclo.gs link? 

Once I see the log, I can identify what's causing the crash and suggest specific fixes.
```

**Teaching/Tutorial:**
```
User: How does the Create mod water wheel work?

Codex: Great question! The water wheel generates rotational power from flowing water.

Here's how to set it up:
1. Place the water wheel next to flowing water
2. [continues step-by-step]

Want to try building one? I can walk you through it!
```

**Emergency/Urgent:**
```
User: SERVER DOWN HELP

Codex: I see you need urgent help. Let me get the info we need:

1. Which server? (ATM10, Stoneblock, etc.)
2. What happened right before it went down?
3. Any error messages?

Staff have been alerted. I'll help troubleshoot while we wait.
```

### What Codex Never Says

❌ "As an AI assistant..."  
❌ "According to my training data..."  
❌ "I don't have access to..."  
❌ "Let me search my database..."  
❌ "Based on my programming..."

✅ "Here's what I found..."  
✅ "Let's figure this out..."  
✅ "I checked our guides..."  
✅ "From our documentation..."  
✅ "I don't know, but I can get staff..."

---

## Chat Formatting

### Discord Responses

**Simple Answer:**
```
Here's how to claim chunks!

1. Stand where you want to claim
2. Type: /flan claim
3. Your chunk is now protected!

Need help with more commands?
```

**With Embedded Rich Content:**
```
📊 Log Analysis Results

**Problem:** OutOfMemoryError in ATM10
**Cause:** Server needs more RAM

**Solutions:**
1. Increase to 24GB (recommended)
2. Reduce render distance to 8
3. Pre-generate chunks

Related docs: [link]
```

**mclo.gs Analysis:**
```
🔍 Analyzing your log...

✅ **Analysis Complete**

**Problem Detected:** [issue]
**Root Cause:** [explanation]

**Solutions:**
1. [step 1]
2. [step 2]

Need help with any of these steps?
```

### Web Interface

**Chat Bubble Format:**
- User messages: Right-aligned, Fire-tinted
- Codex messages: Left-aligned, Frost-tinted
- Timestamp below each message
- Avatar/icon for Codex responses

**Code Blocks:**
- Use monospace font
- Syntax highlighting when possible
- Copy button on hover
- Dark background for code

**Links:**
- Underlined on hover
- Fire orange color (#FF4500)
- Open in new tab

---

## Embedded Widget Appearance

### Chat Bubble (Closed State)

**Design:**
- Circular or rounded square
- Fire/Frost gradient border
- Book or chat icon
- Size: 60x60px
- Position: Bottom right (default)
- Hover: Slight grow animation

**Color Options:**
- Default: Fire/Frost gradient
- Fire theme: Orange gradient
- Frost theme: Cyan gradient

### Chat Window (Open State)

**Header:**
```
┌─────────────────────────────────┐
│ 🔥❄️ Codex                    × │
├─────────────────────────────────┤
```

**Body:**
```
│                                 │
│  [Chat messages here]           │
│                                 │
│                                 │
├─────────────────────────────────┤
```

**Footer:**
```
│ [Type your message...]      [>] │
└─────────────────────────────────┘
```

**Size:**
- Width: 380px (desktop), 100% (mobile)
- Height: 600px (desktop), 80vh (mobile)
- Responsive design

### Branding Elements

**"Powered by Firefrost Codex" Footer:**
- Small text at bottom of widget
- Links to firefrostgaming.com
- Optional: Hide for premium subscribers

---

## Social Media Assets

### Profile Pictures

**Discord Bot:**
- Book with Fire/Frost elements
- Or: Stylized "C" logo
- 512x512px (Discord requirement)
- PNG with transparency

**Social Media (Twitter, Instagram, etc.):**
- Same as Discord bot
- Consistent across platforms
- Recognizable brand

### Cover Images

**YouTube Channel Banner:**
- "Firefrost Codex - 24/7 AI Assistant"
- Fire/Frost branding
- 2560x1440px

**Twitter Header:**
- "Most Minecraft servers have Discord. We have an AI."
- Fire/Frost gradient background
- 1500x500px

### Post Templates

**Announcement Template:**
```
🔥❄️ CODEX UPDATE

[Feature/News]

💡 What this means:
[Benefit to users]

🚀 Try it now:
[How to access]

#FirefrostGaming #CodexAI
```

**Tutorial Template:**
```
📚 ASK CODEX ABOUT: [Topic]

Did you know Codex can help with [specific thing]?

Example:
"@Codex how do I [task]"

Try it yourself! 👇

#FirefrostCodex #Tutorial
```

---

## Marketing Copy Templates

### Short Form (Tweets, Instagram)

**Hook:**
> Most Minecraft servers have Discord. We have an AI.

**Value Prop:**
> 24/7 instant help. Never wait for staff. Gets smarter every day.

**CTA:**
> Ask @Codex anything about Firefrost!

### Medium Form (Discord, Reddit)

**Subscriber Pitch:**
> Every Firefrost subscriber gets 24/7 access to Codex - our AI assistant trained on everything Firefrost. Stuck at 2 AM? Ask Codex. Crash log confusing? Codex analyzes it. Want to master Create mod? Codex teaches you.

**Staff Pitch:**
> Firefrost staff get Codex too. AI handles 80% of common questions, you focus on building and helping with real problems. Plus, instant access to all procedures and infrastructure docs.

### Long Form (Blog, Press)

**Full Story:**
> Firefrost Codex is a self-hosted AI assistant that provides 24/7 support to our entire gaming community. Built on AnythingLLM with local LLM models, Codex knows everything about our servers, modpacks, and procedures. It can answer gameplay questions, analyze crash logs, teach mods step-by-step, and never gets tired or frustrated. Every subscriber gets access at no additional cost - it's part of being Firefrost family.

---

## Launch Assets Checklist

### Visual Assets Needed

- [ ] Primary logo (multiple sizes)
- [ ] Discord bot avatar (512x512)
- [ ] Embedded widget icon
- [ ] Social media profile pictures
- [ ] Social media cover images
- [ ] Website banner/hero image
- [ ] Demo video thumbnail
- [ ] Announcement graphics

### Copy Assets Needed

- [ ] Discord announcement (formatted)
- [ ] Reddit post (r/feedthebeast)
- [ ] Twitter launch thread
- [ ] Instagram caption
- [ ] YouTube video description
- [ ] Website homepage copy
- [ ] FAQ entries
- [ ] Email to subscribers

### Demo Content Needed

- [ ] Video 1: Codex answering questions
- [ ] Video 2: mclo.gs log analysis
- [ ] Video 3: Teaching Create mod
- [ ] Screenshot: Web interface
- [ ] Screenshot: Discord integration
- [ ] Screenshot: Embedded widget

---

## Brand Guidelines Summary

### Do's ✅

- Use Fire/Frost colors consistently
- Keep tone friendly and helpful
- Be transparent about capabilities
- Celebrate community wins
- Show Codex learning and improving
- Credit subscribers who help improve Codex
- Maintain professional but warm personality

### Don'ts ❌

- Don't make it sound robotic/corporate
- Don't oversell capabilities
- Don't hide limitations
- Don't compare negatively to competitors
- Don't use generic AI assistant language
- Don't forget the Fire/Frost theme
- Don't lose the "for children not yet born" heart

---

## Future Branding Considerations

### If Codex Expands Beyond Firefrost

**White-Label Potential:**
- Generic "Codex" branding
- Customizable for other server networks
- Revenue opportunity
- Maintain Firefrost as flagship

### Merchandising Possibilities

- "Powered by Codex" stickers
- T-shirts with Codex mascot
- Community contributor badges
- Limited edition launch items

---

**Fire + Frost + Foundation + Codex = Where Love Builds Legacy** 💙🔥❄️

---

**Document Version:** 1.0  
**Created:** February 20, 2026  
**Status:** Living Document - Update as brand evolves  
**Next Review:** After launch (gather feedback on branding reception)