Roadmap

Where ng-mapcn is heading next, and what has shipped so far.

The roadmap leads to a stable 22.0.0. On the way, the beta line gains new components, search and routing, Angular forms integration, real-time data and better tooling for people and AI assistants. When all of it has shipped, the API is frozen and 22.0.0 is released. What already shipped is at the end of the page.

Stable Release

#
Ongoing

Stable 22.0.0

29%

The destination of this roadmap. Every milestone under What's Next ships on the 22.0.0 beta line first; then the public API is frozen and 22.0.0 is released with semver guarantees, ready for production.

  • Complete roadmap
  • API freeze
  • Semver

Deliverables (2/7)

  • Done: Release process documented (Release-As, prerelease off)
  • Done: Smoke, SSR and accessibility checks on every docs page
  • To do: Every What's Next milestone shipped
  • To do: Public API review: every input, output and export final
  • To do: Release-As: 22.0.0 and "prerelease": false
  • To do: Install commands without @beta in the README and docs
  • To do: Support policy for the 21.x and 18.x lines

What's Next

#
Ongoing

DX, docs & AI

50%

Make ng-mapcn easy to use for people and for coding agents, with first-class tooling for AI assistants.

  • llms.txt
  • Agent skill
  • Docs

Deliverables (2/4)

  • Done: llms.txt and llms-full.txt for agents
  • Done: ng-mapcn agent skill on skills.sh
  • To do: Agent skill recipes generated from the playground scenes
  • To do: Copy page as Markdown and open-in-playground from every docs example
Planned

Search & routing

0%

Find places and draw directions with pluggable providers, so each app chooses its own geocoder and router.

  • Geocoding
  • Directions
  • Providers

Deliverables (0/4)

  • To do: ng-map-search: address search with Nominatim, MapTiler or a custom provider
  • To do: Reverse geocoding on click
  • To do: Directions helper (OSRM, Valhalla or custom) that feeds ng-map-route
  • To do: Isochrones: the area reachable in N minutes
Planned

Angular forms integration

0%

Maps as form inputs: pick a location or draw an area, bound to Signal Forms or reactive forms.

  • Forms
  • Signals

Deliverables (0/3)

  • To do: ng-map-location-picker as a form control (lng/lat)
  • To do: ng-map-draw as a form control for GeoJSON features
  • To do: Bounding-box and radius pickers for search filters
Planned

Real-time data

0%

Live maps from streams: smooth marker movement and layers that update from Observables or signals.

  • Streaming
  • Animation

Deliverables (0/3)

  • To do: Smooth interpolation for markers updated from a stream
  • To do: Layer data from Observables and WebSocket feeds
  • To do: Trails: fading history behind moving markers
Planned

Measure & analyze

0%

Spatial tools on top of ng-mapcn/draw, without a GIS stack.

  • Draw
  • Analysis

Deliverables (0/3)

  • To do: Distance and area measurement tool
  • To do: Select the features inside a drawn polygon
  • To do: Snapping and editing helpers for draw
Planned

Per-component install, shadcn-style

0%

Copy only what you use: pick components and let the schematic resolve the files they depend on.

  • Schematics
  • Registry

Deliverables (0/3)

  • To do: ng g ng-mapcn:map --components=marker,route with dependency resolution
  • To do: Registry manifest mapping each component to its files
  • To do: Block schematics: add a gallery block to your app in one command
Planned

More blocks & templates

0%

Ready-made screens to start from, in the style of the current blocks gallery.

  • Blocks
  • Templates

Deliverables (0/5)

  • To do: Fleet tracking dashboard
  • To do: Real estate search with filters and a results list
  • To do: Travel itinerary with day-by-day routes
  • To do: Weather radar with an animated raster timeline
  • To do: Sales territories with editable regions

Help Shape What's Next

#

The roadmap follows what people build with ng-mapcn. Missing a component or a block? Open a feature request (mention the mapcn equivalent if there is one), or pick a planned item and send a pull request; see CONTRIBUTING.md to get started.

Shipped

#
Completed22.0.0-beta.0 – beta.2 · October 2026

Foundation: the mapcn port

100%

The core of mapcn rebuilt for Angular: standalone components, signal inputs and a component-scoped map context instead of useMap().

  • mapcn parity
  • Signals
  • Copy-paste

Deliverables (7/7)

  • Done: ng-map with theme-driven styles, blank style and a controlled viewport
  • Done: ng-map-controls: zoom, compass, locate and fullscreen
  • Done: Marker family: content, popup, tooltip and label
  • Done: Standalone ng-map-popup
  • Done: Route, GeoJSON, arc and cluster layers
  • Done: ng add and map schematics for the copy-paste install
  • Done: mapcn.dev-style docs site and blocks gallery
Completed22.0.0-beta.3 – beta.6 · October 2026

Developer experience

100%

Typed APIs, styling hooks and translations, so the components fit into real apps and design systems.

  • Type safety
  • Styling
  • i18n
  • Agents

Deliverables (6/6)

  • Done: ng-mapcn agent skill on skills.sh
  • Done: GeoJSON and cluster layers typed by feature properties
  • Done: className inputs for portaled content and controls
  • Done: Configurable, translatable control and a11y labels
  • Done: Popup options and a two-way open input
  • Done: Route progress, active state, RouteProgress and RouteMarker
Completed22.0.0-beta.7 · October 2026

Beyond mapcn

100%

Layers mapcn does not ship yet, plus keyboard access and server rendering out of the box.

  • New layers
  • 3D
  • Accessibility
  • SSR

Deliverables (8/8)

  • Done: ng-map-heatmap
  • Done: Declarative [fitBounds] on ng-map
  • Done: Raster, vector and PMTiles sources plus image overlay
  • Done: 3D buildings, terrain and hillshade
  • Done: ng-mapcn/draw for points, lines and polygons
  • Done: Keyboard access for markers, popups, tooltips and drag
  • Done: Server-side rendering and hydration support
  • Done: Interactive playground and style gallery
Completed22.0.0-beta.8 · October 2026

Playground & scene builder

100%

Compose a map visually, then copy the Angular code that renders it.

  • Playground
  • Code generation

Deliverables (4/4)

  • Done: Scene builder with a draggable layer stack
  • Done: Shareable links and generated component code
  • Done: Example scenes: delivery, flights, earthquakes, Alps, 3D city, sketch
  • Done: 15 basemap presets, from Carto to satellite and globe
Completed22.0.0-beta.9 · October 2026

Testing toolkit

100%

Test apps that use ng-mapcn without WebGL, with the same MapLibre fake the library uses.

  • Testing
  • Harnesses

Deliverables (3/3)

  • Done: ng-mapcn/testing entry point with the MapLibre fake
  • Done: Component harnesses for map, marker and popup
  • Done: "Testing your maps" docs page
Completed22.0.0-beta.10 · October 2026

New components

100%

The building blocks map apps keep rewriting by hand, as composable ng-map children.

  • Components
  • MapLibre

Deliverables (6/6)

  • Done: ng-map-legend for choropleth, heatmap and cluster scales
  • Done: ng-map-scale: metric and imperial scale bar
  • Done: ng-map-minimap: overview map synced with the main viewport
  • Done: ng-map-symbol-layer: icons and text labels from sprites or images
  • Done: ng-map-style-switcher: basemap picker as a control
  • Done: Animated route playback with play, pause and speed