- How do I install speniti/filament-mapbox in a Laravel project?
- Install it with Composer using composer require speniti/filament-mapbox, then follow the package README for any service provider, config, or asset publishing steps. For a new install, confirm your app is on Filament v5 because the current v3 release targets that major version. Review the composer constraints before requiring it in production.
- Does speniti/filament-mapbox support Filament v5?
- Yes, the v3.0.0 release targets Filament v5. That release is explicitly a breaking change tied to the Filament major version, so it should be treated as a coordinated Filament upgrade rather than a routine package bump. Applications still on Filament v4 or earlier should not expect v3.0.0 to be a drop-in replacement.
- Can I use this package with Filament v4?
- The current v3 line is coupled to Filament v5, so it is not intended as a drop-in for Filament v4 applications. Existing Filament v4 projects should either stay on an older compatible package release or upgrade Filament to v5 first. Check the package composer constraints and release notes before choosing a version.
- How do I add a Mapbox location picker to a Filament form?
- Use the package's Filament form field inside your form schema and configure it with your Mapbox access token as documented. The field provides an interactive map, address search, and a draggable marker, and it stores the selected coordinates for your model. Because exact class names and configuration keys can change between major versions, verify the component usage in the README for your installed version.
- Do I need a Mapbox access token to use speniti/filament-mapbox?
- Yes, Mapbox maps and geocoding require a Mapbox access token. Configure the token through the package configuration or environment variables as described in the documentation. Use a public token with appropriate URL restrictions and avoid exposing a secret token in client-side code.
- How does address search and autocomplete work in this package?
- The package adds address search and autocomplete to the map field, typically using Mapbox geocoding to turn a typed address into a location. When a user selects an address, the map marker and stored coordinates update. Exact behavior and configuration options should be checked in the package documentation.
- Can users drag the marker to set coordinates?
- Yes, the package includes a draggable marker so users can adjust the selected point on the map. The updated latitude and longitude are then stored through the Filament form field. Validate the saved coordinate format in your application before using it in downstream geospatial logic.
- Is speniti/filament-mapbox safe for production use?
- Treat it as a Filament-version-coupled dependency and validate it in a non-production branch first. The v3.0.0 release is a major breaking change targeting Filament v5, and the provided release notes do not include detailed migration or test-coverage information. Pin the major version, review the issue tracker and README, and run application-specific tests before deploying.
- How do I migrate from v2 to v3 of speniti/filament-mapbox?
- Plan the migration as part of a Filament v5 upgrade, not as an isolated Composer update. Create a branch, upgrade Filament, update the package to v3.0.0, and then test panel registration, configuration, published assets, and form behavior. The release notes provide only the headline breaking change, so consult the README and issue tracker for any additional migration details.
- What should I check before choosing speniti/filament-mapbox over alternatives?
- Confirm that your application is on Filament v5 and that the package's Mapbox field features match your needs, such as address autocomplete, draggable markers, and coordinate storage. Compare maintenance activity, Filament version support, documentation, and test coverage with other Filament map packages or a custom Mapbox field. For teams not ready for Filament v5, deferring this package or using an older compatible release is safer.