- How do I install and register imumz/nova-4-card-map in a Laravel Nova 4 application?
- Install it with Composer using composer require imumz/nova-4-card-map, which pulls in the card class plus the pre-compiled dist assets. The package ships a service provider with Composer auto-discovery, so no manual PHP provider registration is needed. You still have to register the card itself, typically by adding it to the array returned by Nova::cards() in your NovaServiceProvider. Confirm the exact card class name and any config arguments against the repository README before wiring it up.
- Does imumz/nova-4-card-map work with Nova 5?
- The package is built explicitly as a Laravel Nova 4 card, and no Nova 5 compatibility statement appears in the material provided. Nova cards are coupled to Nova's internal, version-specific Vue component contract, so a Nova 4 card can break under Nova 5 without modification. Treat Nova 5 support as unverified and smoke-test the card on a staging Nova install before committing to it.
- How do I add markers and coordinates to the map card?
- The card is designed to accept marker coordinates and map settings that you pass through its configuration so location-based model data can be plotted on a Leaflet map. The exact method names and payload shape are not covered in the overview, so check the README and the card's PHP class for fluent setters or constructor arguments. Validate with a few known coordinates first, then feed in values coming from your Eloquent queries.
- Does this Nova map card need a Google Maps or Mapbox API key?
- The card renders with Leaflet, an open-source mapping library that typically works with free or self-hosted tile sources rather than a paid JavaScript SDK. That does not rule out a tile provider or geocoding service expecting a key, and nothing in the provided description confirms or denies it. Check the README and the compiled bundle for external domain calls before assuming no account is required.
- Is the compiled JavaScript and CSS bundle included, or do I have to build it myself?
- Nova cards normally ship a pre-compiled bundle at dist/js/card.js and dist/css/card.css, because rebuilding them requires Laravel Nova's proprietary laravel-nova toolchain. The package description does not explicitly confirm the dist assets are committed, so verify this before installing. If the bundle is missing you would need a Nova licence and the Nova dev tooling to build it, which changes the effort significantly.
- Which Laravel and PHP versions does imumz/nova-4-card-map support?
- No support matrix for Laravel 9, 10 or 11, or for PHP 8.1, 8.2 or 8.3, is published in the material provided. The card targets Nova 4, so your practical ceiling is whatever Laravel and PHP range that Nova 4 release supports. Run a dry-run Composer install in staging to confirm the dependency constraints resolve on your stack.
- Is imumz/nova-4-card-map safe and maintained enough for production?
- The bus factor is one: this is a single-maintainer package with minimal release history and no visible community validation or dependents. A Nova card executes inside your authenticated admin surface, so an unvetted PHP class and JavaScript bundle is a genuine addition to your attack surface that warrants vendor review before production. If you adopt it, pin the version, fork it into a private registry with a named owner, and re-review on every Nova upgrade.
- How should I test a Nova card like this before rolling it out?
- Stand up a staging Laravel plus Nova 4 app, install the card, register it via Nova::cards(), and confirm the dashboard renders with real marker data rather than only sample coordinates. Watch the browser network tab for outbound tile or geocoding requests so you know exactly which third-party domains the card contacts. Also verify the card degrades gracefully when a model has null or invalid coordinates.
- Can I customise the map centre, zoom level and marker icons?
- The package description mentions custom map settings, so options such as the initial centre point and zoom level are likely exposed through the card's configuration methods. Marker styling and popup content usually depend on what the card passes down to Leaflet, which may mean publishing or overriding the Vue component to change icons. Since the repository README is the source of truth, confirm the available setters there before planning customisations.
- What are the alternatives if this card is abandoned, and what would a rebuild cost?
- A Nova card is a bounded extension point, so a scoped rebuild is small: a PHP class extending Laravel\Nova\Card plus a Vue component that mounts a Leaflet map, roughly one to three engineer-days. That makes the package a sensible read-and-fork candidate rather than a long-term runtime dependency. Alternatives include other community Nova map cards or an in-house card you fully control.