Filament Pinpoint Laravel Package

Product Decisions This Supports

• Geospatial Features for Filament Admin Panels: Enables location-based workflows (e.g., property listings, delivery zones, service areas) without building custom UI.
• Cost Optimization: Offers a free alternative (Leaflet/OpenStreetMap) to Google Maps, reducing API costs for non-critical use cases.
• Multi-Location Management: Supports repeaters for managing multiple locations (e.g., branch networks, ride-sharing drivers) in a single form.
• Radius-Based Features: Enables proximity-based logic (e.g., "Show all users within 5km of this location") via the interactive radius tool.
• Reverse Geocoding: Automates address field population, reducing manual data entry for location-heavy apps (e.g., real estate, logistics).
• Dark Mode & Localization: Aligns with Filament’s design system and supports global audiences without additional dev work.
• Roadmap for Filament 5: Future-proofs location features as Filament evolves, avoiding migration pain.

When to Consider This Package

• Avoid if:
  • Your app doesn’t need maps (e.g., CRM, invoicing tools).
  • You’re already using a dedicated geospatial solution (e.g., PostGIS, Mapbox SDK).
  • Your team lacks Filament expertise (steep learning curve for non-Filament devs).
  • You need advanced geospatial queries (e.g., heatmaps, route optimization) beyond basic markers/radius.
• Look elsewhere if:
  • You require offline maps (Leaflet/OpenStreetMap has limited offline support).
  • Your use case demands real-time tracking (consider WebSocket + Mapbox GL JS).
  • You’re on Filament 3 or Laravel <10 (incompatible).

How to Pitch It (Stakeholders)

For Executives: "This package lets us add Google Maps-style location pickers to our Filament admin panels—for free if we use OpenStreetMap. It cuts dev time by 80% for features like property listings, delivery zones, or branch networks. No API costs for basic use cases, and it supports dark mode/localization out of the box. Example: A real estate tool could auto-fill addresses from coordinates, saving agents hours of manual data entry."

For Engineers: *"A drop-in Filament component for maps with:

• Two providers: Google Maps (paid) or Leaflet/OpenStreetMap (free).
• Key features: Search, draggable markers, reverse geocoding, radius tools, and repeater support.
• Zero frontend work: Just add Pinpoint::make('location') to your form.
• Dark mode & i18n: Built-in Filament compatibility. Use case: Replace custom map UIs in Filament apps (e.g., for location-based CRUD)."*