# MCPTesta Logo Assets

This directory contains the complete logo asset collection for the MCPTesta project, featuring the "Lab Experiment in Progress" design that represents community-driven testing excellence for the MCP ecosystem.

## 🧪 Design Concept

The MCPTesta logo depicts an active laboratory experiment with:
- **Erlenmeyer Flask**: Scientific beaker showing ongoing reactions
- **Bubbling Activity**: Dynamic bubbles representing test execution
- **Mini Test Tubes**: Parallel testing status indicators
- **Lab Apparatus**: Professional clamp and stand for authenticity
- **Community Colors**: Warm purple gradient with accessible cyan accents

## 📁 Directory Structure

```
logo/
├── source/           # Master files (SVG, design specs)
├── favicons/         # Web favicons and browser icons
├── app-icons/        # iOS and Android app icons
│   ├── ios/          # Apple App Store sizes
│   └── android/      # Google Play Store sizes
├── web/              # Web-optimized PNG/SVG files
├── social/           # Social media profile and card images
├── print/            # Print-ready files (CMYK, vector)
└── theme-variants/   # Dark, light, high-contrast versions
    ├── dark-theme/
    ├── light-theme/
    └── high-contrast/
```

## 🎨 Usage Guidelines

### Primary Logo Usage
- Use the full-color version whenever possible
- Maintain minimum size of 32px for web contexts
- Preserve the lab experiment elements in all variations
- Use appropriate theme variants for dark/light contexts

### Color Specifications
- **Primary Background**: #6B46C1 → #8B5CF6 (purple gradient)
- **Active Liquid**: #0891B2 → #06B6D4 (teal to cyan)
- **Status Indicators**: Green (#10B981), Amber (#F59E0B), Red (#EF4444)
- **Glass/Metal**: Semi-transparent whites and grays

### Accessibility
- All versions meet WCAG AA contrast requirements
- High-contrast variants available for accessibility needs
- Colorblind-friendly status indicators provided
- Alternative text: "MCPTesta - Laboratory testing framework logo"

## 🚀 Quick Integration

### Documentation Site (Starlight)
```html
<!-- Site header -->
<img src="/assets/logo/web/mcptesta-horizontal-logo.svg" 
     alt="MCPTesta - Community-driven testing excellence" />

<!-- Favicon -->
<link rel="icon" type="image/svg+xml" href="/assets/logo/favicons/favicon.svg">
<link rel="icon" type="image/png" sizes="32x32" href="/assets/logo/favicons/favicon-32x32.png">
```

### README.md
```markdown
<div align="center">
  <img src="assets/logo/web/mcptesta-logo-256px.png" alt="MCPTesta Logo" width="128" height="128">
  <h1>MCPTesta</h1>
  <p>Community-driven testing excellence for the MCP ecosystem</p>
</div>
```

### Social Media
- **Profile Pictures**: Use `social/profile-400x400.png`
- **Cover Images**: Use `social/header-1500x500.png`
- **Card Previews**: Use `social/card-1200x630.png`

## 📋 File Status

### ✅ Completed Specifications
- [x] Design specifications (`../logo-design-specs.md`)
- [x] Color variations (`../logo-color-variations.md`)
- [x] Contextual variants (`../logo-variations-guide.md`)
- [x] Export specifications (`../logo-export-specifications.md`)
- [x] Testing matrix (`../logo-testing-matrix.md`)

### 🔄 Pending Asset Creation
- [ ] Master SVG files
- [ ] Generated PNG exports
- [ ] Favicon package
- [ ] Social media assets
- [ ] Theme variants

## 🛠 Generation Scripts

Use the provided scripts to generate all logo assets:

```bash
# Generate all export formats
./scripts/generate-logo-exports.sh

# Run quality assurance checks
./scripts/qa-logo-check.sh

# Optimize for web delivery
./scripts/optimize-web-assets.sh
```

## 📞 Support

For logo usage questions or custom variations:
- Review the comprehensive specifications in parent directory
- Check the testing matrix for platform-specific guidance
- Ensure accessibility compliance for public-facing usage

---

*Created with scientific precision for the MCPTesta community* 🧪