Filament Simple Map Laravel Package

Product Decisions This Supports

• Geospatial Data Visualization: Enables quick integration of interactive maps into Filament admin panels for location-based data (e.g., customer addresses, asset tracking, or field service management).
• Accelerated MVP Development: Reduces time-to-market for location-aware features by leveraging a pre-built, Google Maps-powered component instead of custom development.
• Roadmap for Advanced Mapping: Serves as a lightweight foundation for future upgrades (e.g., switching to a self-hosted solution like Leaflet or Mapbox if API costs become prohibitive).
• Build vs. Buy: Favors "buy" for teams lacking frontend expertise or time to build a custom map solution, while still allowing for future customization via Filament’s extensibility.
• Use Cases:
  • Displaying customer locations in a CRM.
  • Visualizing field technician routes or service areas.
  • Adding geospatial context to inventory or asset management systems.

When to Consider This Package

• Adopt if:

  • Your team uses Filament and needs a quick, low-code map integration with minimal setup.
  • You’re comfortable with Google Maps API (costs and usage limits are acceptable).
  • Your use case requires basic interactivity (zooming, panning, embedded markers) without complex routing or geocoding.
  • You prioritize developer velocity over full control of the map’s frontend (e.g., no need for custom markers or layers).

• Look elsewhere if:

  • You need offline functionality or self-hosted maps (e.g., MapLibre, OpenStreetMap).
  • Your app requires advanced features like geocoding, directions, or heatmaps (consider dedicated libraries like Filament Maps or Leaflet).
  • Your budget is sensitive to Google Maps API costs (pay-as-you-go pricing can escalate).
  • You’re building a public-facing app where iframes may pose security/UX risks (e.g., cross-origin restrictions).

How to Pitch It (Stakeholders)

For Executives: "This package lets us embed interactive Google Maps directly into our Filament admin panel with just a few lines of code—no frontend dev work required. It’s ideal for quickly adding location context to customer data, field operations, or logistics without the overhead of custom development. The trade-off is reliance on Google’s API, but for our current scale and use cases, it’s a cost-effective way to accelerate feature delivery. We can always migrate to a self-hosted solution later if needed."

For Engineering: *"Filament Simple Map is a lightweight wrapper around Google Maps’ embed API, designed for minimal setup. It’s perfect for:

• Prototyping: Test location features fast (e.g., ‘Show me all stores on a map’).
• Admin Panels: Add maps to Filament resources without touching Blade or JS.
• Future-Proofing: The config is publishable, so we can tweak the API key or switch providers later. Downside: Limited customization (e.g., no dynamic markers), but it’s a great starting point. For complex needs, we’d pair it with a dedicated mapping library."*

For Design/UX: "This gives us a familiar, user-friendly map interface with zero additional training for admins. The iframe approach means no extra styling work, and the interaction (zoom/pin) is intuitive. If we hit limits (e.g., need custom icons), we can escalate to a more robust solution."