Download Latest Version v3.28.1 source code.zip (321.8 MB)
Email in envelope

Get an email when there's a new version of Mapbox GL JS

Home / v3.28.0
Name Modified Size InfoDownloads / Week
Parent folder
README.md 2026-08-05 1.6 kB
v3.28.0 source code.tar.gz 2026-08-05 316.7 MB
v3.28.0 source code.zip 2026-08-05 321.8 MB
Totals: 3 Items   638.6 MB 0

Breaking changes ⚠️

  • Disable text-variable-anchor when appearances are present.

Features and improvements ✨

  • Introduce experimental map.getVerticalFieldOfView(), map.setVerticalFieldOfView(), and read-only map.getHorizontalFieldOfView() and an animatable fov camera option.
  • Expose line-border-width and line-border-color as public paint properties.
  • Introduce experimental line-border-gradient property for rendering gradient borders on lines.
  • Add support for Meshopt v1 compressed models.
  • Support string color values for the model-color in a model source.
  • Add map.resetFeatureStates() to clear all feature states for a featureset or layer.
  • Expose map.getSchema()/map.setSchema() for managing the imported style's schema.
  • Extract development and debug code from the ESM bundle into a separate module.
  • Extract more model code from the ESM core bundle.
  • Extract raster-array layer as a separate ESM module.
  • Reduce the bundle size by restructuring style, program, symbol, and expression code.
  • Remove experimental flag from layer appearances.
  • Improve symbol layer performance.
  • Reduce redundant repaints and checks during initial load.

Bug fixes 🐞

  • Fix double rotation of the FF5C character in vertical text rendering.
  • Preserve live gesture when camera setter is called from inside a drag/move handler.
  • Stop overwriting the pointerEvents of markers set by the user.
  • Fix models with vertex alpha 0 appearing black.
  • Fix incorrect rendering of fill extrusions with fill-extrusion-edge-radius at low zoom levels in some cases.
Source: README.md, updated 2026-08-05