This workshop will provide an introduction to building your own Extensions for the MapStore Open Source framework, an highly modular Open Source WebGIS framework to create, manage and securely share maps and geospatial applications. An Extension is a plugin component that can be distributed as a separate package (a zip file), and be installed, activated and used at runtime. Creating an extension allows a developer to add custom components and functionalities to the map viewer.
The workshop provides an overview of the MapStore technological stack and introduces to the development of a MapStore extension.

The topics covered during the workshop are the following:
- Introduction to MapStore
- How to setup the development environment for a MapStore Extension
- Introduction to the development of an Extension
- Installation of an Extension inside a MapStore context map viewer

Pre-requirements for attendees

The material we are going to use during the workshop is available online at the following links:
- MapStore demo https://mapstore.geosolutionsgroup.com/mapstore
- MapStore repository https://github.com/geosolutions-it/MapStore2
- MapStoreExtension documentation https://docs.mapstore.geosolutionsgroup.com/en/latest/developer-guide/extensions/
- MapStoreExtension repository https://github.com/geosolutions-it/MapStoreExtension

Additional needed tools:

• Git - see git guides for installation instructions https://github.com/git-guides/install-git
• NodeJS version 20, installation alternatives:
• Installation with nvm https://github.com/nvm-sh/nvm
• Installation with nvm-windows https://github.com/coreybutler/nvm-windows
• Download from node.js https://nodejs.org/en/download
• Code editor (e.g. Visual Studio Code) https://code.visualstudio.com/

For those that want to follow hands on, we suggest to prepare previous listed tools beforehand and:

• Download mapstore2-2026.01.02-bin.zip to test MapStore WebGIS functionalities locally (Release v2026.01.02)
• Setup the MapStoreExtension repository:
• Navigate in your workspace folder and clone the repository with: git clone -b 2026.01.xx --recursive https://github.com/geosolutions-it/MapStoreExtension
• Navigate inside MapStoreExtension with: cd ./MapStoreExtension
• Install all the dependencies with npm (node version 20 must be installed) with: npm install

A basic knowledge of JavaScript and ReactJS is needed for the development setup.