🎨 Add custom logo embedding in QR codes

[jane-alesi]

Add Custom Logo Embedding in QR codes

Description

Implement the ability to embed custom logos or images in the center of QR codes while maintaining readability and error correction.

Tasks

Logo Integration Research

• Research optimal logo size relative to QR code dimensions
• Study error correction level requirements for logo embedding
• Test readability with different logo sizes and styles
• Investigate logo positioning and masking techniques

Implementation

• Add logo parameter to tool schema (base64 image or URL)
• Implement logo preprocessing (resize, format conversion)
• Add logo placement logic in center of QR code
• Implement proper masking to maintain QR code integrity
• Add logo scaling based on QR code size

API Design

// Tool parameter extension
logo: z
  .string()
  .optional()
  .describe('Base64 encoded logo image to embed in QR code center'),
logoSize: z
  .number()
  .min(0.1)
  .max(0.3)
  .default(0.2)
  .describe('Logo size as percentage of QR code (0.1-0.3)'),

Advanced Features

• Support multiple image formats (PNG, JPG, SVG)
• Auto-detect optimal logo size based on error correction
• Add logo border/padding options
• Implement logo shape options (circle, square, custom)
• Add logo transparency/opacity controls

Quality Assurance

• Test QR code readability with various logo sizes
• Validate across different QR code readers/scanners
• Performance testing with logo processing
• Test edge cases (very small/large logos)
• Cross-platform compatibility testing

Documentation

• Add logo embedding examples to README
• Document logo size recommendations
• Add best practices for logo design in QR codes
• Include troubleshooting guide for readability issues

Technical Considerations

• Logo should not exceed 20-30% of QR code area
• Higher error correction levels (Q/H) required for logo embedding
• Logo preprocessing may impact generation performance
• Need to handle various image formats and sizes
• Consider caching preprocessed logos for performance

Use Cases

• Brand recognition in marketing campaigns
• Corporate QR codes with company logos
• Event tickets with event branding
• Business cards with personal/company logos

Acceptance Criteria

• QR codes with logos remain fully readable
• Logo quality is preserved at appropriate sizes
• Performance impact is minimal
• Support for common image formats
• Clear error messages for invalid logos

Priority

🔵 Low - Advanced feature for enhanced branding

Dependencies

• Depends on core infrastructure being stable
• May benefit from SVG support (✨ Add SVG output format support #7) for vector logos