filament_mobile_maps

Optional map rendering for filament_mobile. The core package parses the map_point contract but takes no mapping dependency; this companion renders it with flutter_map and OpenStreetMap-compatible raster tiles.

flutter pub add filament_mobile_maps

final fields = FieldRegistry.defaults()
  ..register('map_point', mapFieldBuilder());
final entries = EntryRegistry.defaults()
  ..register('map_point_entry', mapEntryBuilder());

PanelShell(
  source: source,
  panelProvider: panelProvider,
  fieldRegistry: fields,
  entryRegistry: entries,
);

The renderer honours the server-published interaction, marker, zoom, tile URL, and attribution hints. Attribution is always visible; when the server omits it, the renderer shows © OpenStreetMap contributors.

The server owns the tile template. Before production, configure a tile service whose usage policy and capacity fit your application; the public OpenStreetMap template is a compatible default, not a capacity guarantee. Hosts can also inject a TileProvider into either builder, which is useful for authenticated or cached delivery and keeps widget tests network-free.

These builders replace only map fields and entries. You can simultaneously pass a FilamentWidgetRegistry to PanelShell to add any host-owned Flutter widget before or after package content wherever your application needs it.

Map drawing/GeoJSON, geocoding, place search, keyed tile providers, and offline tile storage are intentionally outside this package.