Filament Company Logo Column Laravel Package

Product Decisions This Supports

• Enhancing B2B SaaS Admin Panels: Ideal for platforms managing customer portfolios (e.g., CRM, marketplace, or subscription services) where visual identification of companies improves UX and reduces cognitive load.
• Roadmap for "Branded UI" Features: Justifies investment in visual identity tools (e.g., logo columns, avatars) to differentiate from competitors with generic text-only admin panels.
• Build vs. Buy: Avoids reinventing logo-fetching logic (e.g., parsing URLs, handling favicons, or proxying images) by leveraging Logo.dev’s API. Reduces backend complexity compared to self-hosted solutions.
• Use Cases:
  • Customer Management: Display logos in tables listing clients, partners, or vendors.
  • Marketplace/Platforms: Show vendor or seller logos in admin dashboards.
  • Internal Tools: Replace placeholder icons in internal tools tracking external entities (e.g., "Integrations" or "Affiliates" tables).

When to Consider This Package

• Adopt When:

  • Your Filament-based admin panel manages entities with domain/URL attributes (e.g., website, primary_url).
  • You prioritize low-maintenance visuals over custom branding (e.g., no need for SVG uploads or local logo storage).
  • Your team lacks bandwidth to build a logo-fetching service (e.g., parsing favicons, handling redirects, or caching).
  • You’re using Logo.dev (or willing to pay for their API) and want to avoid exposing their key in frontend code.
  • You need quick integration (5–10 minutes to configure) without sacrificing quality (HiDPI support, dark mode).

• Look Elsewhere If:

  • You require custom logo uploads (e.g., SVG/PNG files stored in your database).
  • Your use case demands offline/air-gapped support (Logo.dev requires internet access).
  • You need advanced logo processing (e.g., cropping, resizing, or dynamic watermarks).
  • Your budget prohibits Logo.dev’s pay-as-you-go pricing (free tier has limits).
  • You’re using Filament < 5.x or PHP < 8.2 (hard dependency).

How to Pitch It (Stakeholders)

For Executives:

*"This package lets us add professional company logos to our admin tables—like a CRM or marketplace dashboard—with almost zero engineering effort. Instead of showing just text (e.g., ‘Acme Corp’) or broken favicon links, users see a visual identifier (e.g., the Acme logo) on hover. It’s a small but high-impact UX upgrade that:

• Reduces errors: Logos prevent misclicks on similar-sounding company names.
• Saves dev time: No need to build a logo-fetching service; we pay Logo.dev (~$0.01–$0.05 per logo) for a turnkey solution.
• Future-proofs: Easy to extend (e.g., add click-through to company profiles). Cost: ~$50–$200/month for moderate usage. ROI: Faster onboarding for admins, better data trust."*

For Engineers:

*"This is a drop-in Filament column that:

• Renders logos from domains/URLs via Logo.dev’s API (e.g., example.com → logo).
• Handles edge cases: Invalid domains, missing keys, or IPs fall back to a neutral placeholder.
• Optimized: Lazy-loads images, supports HiDPI, and respects dark mode.
• Configurable: Adjust size, format (WebP/PNG), theme, and fallback behavior. Trade-offs:
• No local caching (relies on Logo.dev + browser cache).
• Requires a Logo.dev API key (MIT-licensed, but paid after free tier). How to use:

1. Install via Composer.
2. Add your Logo.dev key to .env.
3. Replace a TextColumn with CompanyLogoColumn::make('website') in your Filament resource. Example:

CompanyLogoColumn::make('website')
    ->size(48)
    ->tooltip(fn ($record) => $record->name)

Alternatives: Building this yourself would require parsing URLs, fetching favicons, and handling redirects—this package does it in ~100 lines of code."*