pdf-accessibility/README's/OLIVER_CUSTOMIZATION.md

🎨 Oliver Customization Summary

✅ All Changes Applied

🎨 Branding Updates

Colors

• Primary: #FFC407 (Oliver Yellow) ✅
• Secondary: #000000 (Black) ✅
• Previous: Blue (#2563eb) → Replaced with Yellow/Black

Typography

• Font: Montserrat (all weights: 400, 600, 700) ✅
• Loaded from: Google Fonts CDN
• Applied to: Entire application

Design Elements

✅ Black header with yellow accent border ✅ Yellow primary buttons with black text ✅ Black/yellow gradient score display ✅ Montserrat font across all text ✅ Yellow hover states ✅ Professional, high-contrast design

---

🤖 AI Model Update

Claude Sonnet 4.5 ✅

• Model: claude-sonnet-4-5-20250929
• Previous: claude-3-5-sonnet-20241022
• Benefits: Higher accuracy, better recommendations, improved image analysis
• Cost: Same as 3.5 (~$0.015 per image)

---

🐍 Python venv Support

api.php Updates ✅

// Automatically detects and uses venv Python
$venv_python = __DIR__ . '/venv/bin/python3';
$python_bin = file_exists($venv_python) ? $venv_python : 'python3';

What this means:

• ✅ Works with or without venv
• ✅ No manual configuration needed
• ✅ Falls back to system Python if venv not present
• ✅ MAMP-friendly

---

📦 New Files Added

1. MAMP_SETUP.md (12KB)

   • Complete MAMP setup guide
   • venv instructions
   • Troubleshooting
   • Daily workflow
   • API key configuration

2. install_venv.sh (5.7KB)

   • Automated venv setup
   • Installs dependencies in venv
   • Creates directories
   • Tests installation
   • Interactive prompts

---

🗂️ File Changes

index.html (25KB) ✅

<!-- Added Montserrat font -->
<link href="https://fonts.googleapis.com/css2?family=Montserrat:wght@400;600;700&display=swap" rel="stylesheet">

<!-- Updated CSS variables -->
:root {
    --primary: #FFC407;        /* Oliver Yellow */
    --black: #000000;          /* Oliver Black */
    --primary-dark: #e6b006;   /* Darker yellow */
}

<!-- Updated header -->
<header style="background: black; border-bottom: 3px solid yellow;">

api.php (7.3KB) ✅

// Auto-detect venv Python
$venv_python = __DIR__ . '/venv/bin/python3';
$python_bin = file_exists($venv_python) ? $venv_python : 'python3';

enterprise_pdf_checker.py (44KB) ✅

# Updated model
model="claude-sonnet-4-5-20250929"

---

🚀 Quick Start for MAMP

Installation

# 1. Run venv installer
chmod +x install_venv.sh
./install_venv.sh

# 2. Copy to MAMP (choose one)
# Option A: Copy
cp -r . /Applications/MAMP/htdocs/pdf-checker

# Option B: Symlink
ln -s $(pwd) /Applications/MAMP/htdocs/pdf-checker

# 3. Set API keys
export ANTHROPIC_API_KEY="sk-ant-api03-YOUR-KEY"
export GOOGLE_APPLICATION_CREDENTIALS="/path/to/creds.json"

# 4. Start MAMP and visit
open http://localhost:8888/pdf-checker/

Daily Usage

# Activate venv (for Python development)
source venv/bin/activate

# Run checks
python enterprise_pdf_checker.py test.pdf

# Deactivate when done
deactivate

For web interface: Just use MAMP - api.php handles venv automatically! 🎉

---

🎯 What You Get

✅ Oliver Branding

• Black and yellow color scheme
• Montserrat font throughout
• Professional, high-contrast design
• Maintains accessibility while being on-brand

✅ Claude Sonnet 4.5

• Latest and most capable model
• Better accuracy for accessibility checks
• Improved recommendations
• Same cost structure

✅ venv Support

• Isolated Python environment
• MAMP-compatible
• Automatic detection in api.php
• No manual configuration needed

✅ Complete Documentation

• MAMP_SETUP.md - Detailed setup guide
• install_venv.sh - Automated installation
• All original docs still included
• Troubleshooting section

---

📊 Before vs After

Feature	Before	After
Primary Color	Blue (#2563eb)	Yellow (#FFC407) ✅
Secondary Color	Light Blue	Black (#000000) ✅
Font	System default	Montserrat ✅
AI Model	Claude 3.5 Sonnet	Claude 4.5 Sonnet ✅
Python	System Python	venv support ✅
MAMP Guide	Generic setup	Specific MAMP guide ✅

---

🔍 Visual Changes

Header

Before: White background, blue text
After:  Black background, yellow text, yellow border

Buttons

Before: Blue background, white text
After:  Black background, yellow text, yellow border
        Hover: Yellow background, black text

Score Display

Before: Purple gradient
After:  Black gradient with yellow accents

Typography

Before: System fonts (-apple-system, etc.)
After:  Montserrat for all text

---

🎨 Color Palette

/* Oliver Brand Colors */
--primary: #FFC407;        /* Yellow - main brand color */
--primary-dark: #e6b006;   /* Darker yellow for hover */
--primary-darker: #cc9d05; /* Even darker for active states */
--black: #000000;          /* Black - secondary brand color */

/* Status Colors (unchanged for accessibility) */
--success: #10b981;        /* Green */
--warning: #f59e0b;        /* Orange */
--error: #ef4444;          /* Red */
--critical: #dc2626;       /* Dark red */
--info: #3b82f6;           /* Blue */

---

🛠️ Technical Details

Font Loading

<link rel="preconnect" href="https://fonts.googleapis.com">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link href="https://fonts.googleapis.com/css2?family=Montserrat:wght@400;600;700&display=swap" rel="stylesheet">

venv Detection

// In api.php
$venv_python = __DIR__ . '/venv/bin/python3';
$python_bin = file_exists($venv_python) ? $venv_python : 'python3';

Model Configuration

# In enterprise_pdf_checker.py
self.anthropic_client.messages.create(
    model="claude-sonnet-4-5-20250929",
    max_tokens=1024,
    messages=[...]
)

---

✅ Testing Checklist

Before deploying, verify:

• Header is black with yellow accent
• All text uses Montserrat font
• Primary buttons are black with yellow text
• Hover states show yellow background
• Score display has black/yellow gradient
• Upload area uses appropriate colors
• API returns Claude Sonnet 4.5 responses
• venv Python is used when available
• System Python works as fallback
• All functionality works in MAMP

---

📞 Need to Customize More?

Change Colors

Edit index.html, find:

:root {
    --primary: #FFC407;  /* Change this */
    --black: #000000;    /* Or this */
}

Change Font

Edit index.html, find:

<link href="https://fonts.googleapis.com/css2?family=Montserrat:wght@400;600;700&display=swap" rel="stylesheet">

Replace Montserrat with your font, then update:

body {
    font-family: 'YourFont', sans-serif;
}

Change Model

Edit enterprise_pdf_checker.py, find:

model="claude-sonnet-4-5-20250929"

---

🎉 Summary

You now have: ✅ Oliver-branded web interface (Black + Yellow #FFC407) ✅ Montserrat font throughout ✅ Claude Sonnet 4.5 integration ✅ venv support with automatic detection ✅ MAMP-optimized setup ✅ Complete documentation

Everything is ready for MAMP local development! 🚀

Start with: ./install_venv.sh then check out MAMP_SETUP.md